oz0 channel bind

Create or replace a binding.

For: Operators and developers looking up a command.

Create or replace a binding. The first --agent is the one a mention or a slash command starts when it names none; a message whose first word is another of the agents starts that one. --workspace and --room narrow the binding to one workspace and one room of the chat system (their IDs there); the most specific binding wins.

Usage

oz0 channel bind <name> --channel <channel> --agent <agent> [--agent <agent>...] [flags]

Flags

FlagTypeDefaultDescription
--agentstringArrayan agent the channel may start (repeatable; the first is the default)
--allowstringmemberswho may start the agents: members (mapped people, as their accounts) or everyone (as service:channel/<name>)
--channelstringthe channel, as its plugin names it (such as slack or discord)
--jsonboolprint JSON instead of a table
--purposestringthe purpose the jobs it starts name: one each of its agents declares
--roomstringonly in this room (a channel ID)
--teamstringthe team the jobs count toward for quotas
--tenantstringdefaulttenant
--workspacestringonly in this workspace of the chat system (a Slack workspace or Discord server ID)

Inherited flags

FlagTypeDefaultDescription
--contextstring$OZ0_CONTEXT or <config dir>/orchestrator-zero/context.jsonCLI context file written by server init
--log-levelstringinfolog level: debug, info, warn or error

See all oz0 commands and the global flags.

On this page
Copyright © 2026