`openclaw agents`

管理隔离的智能体（工作区 + 凭证 + 路由）。不带子命令运行 openclaw agents 等同于 openclaw agents list。相关：

多 Agent 路由
Agent 工作区
Skills 配置：技能可见性配置。

示例

openclaw agents list
openclaw agents list --bindings
openclaw agents add work --workspace ~/.openclaw/workspace-work
openclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:*
openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactive
openclaw agents bindings
openclaw agents bind --agent work --bind telegram:ops
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
openclaw agents set-identity --agent main --avatar avatars/openclaw.png
openclaw agents delete work

命令接口

`agents list`

选项：--json、--bindings（包含完整路由规则，而不只是每个智能体的计数/摘要）。

`agents add [name]`

选项：--workspace <dir>、--model <id>、--agent-dir <dir>、--bind <channel[:accountId]>（可重复）、--non-interactive、--json。

传入任何显式添加标志都会将命令切换到非交互路径。
非交互模式同时需要智能体名称和 --workspace。
main 为保留值，不能用作新的智能体 ID。
交互模式会通过仅复制可移植的静态凭证（api_key 和静态 token 配置文件）来初始化凭证，除非某个凭证通过 copyToAgents: false 选择退出；OAuth 刷新令牌配置文件不会被复制，除非某个提供商通过 copyToAgents: true 选择加入。如果没有复制，OAuth 只能通过从真实 main 智能体存储透传读取继承来保持可用。如果配置的默认智能体不是 main，请在新智能体上单独登录 OAuth 配置文件。

`agents bindings`

选项：--agent <id>、--json。

`agents bind`

选项：--agent <id>（默认为当前默认智能体）、--bind <channel[:accountId]>（可重复）、--json。

`agents unbind`

选项：--agent <id>（默认为当前默认智能体）、--bind <channel[:accountId]>（可重复）、--all、--json。接受 --all 或一个或多个 --bind 值，但不能同时使用两者。

`agents set-identity`

选项：--agent <id>、--workspace <dir>、--identity-file <path>、--from-identity、--name <name>、--theme <theme>、--emoji <emoji>、--avatar <value>、--json。见下方设置身份。

`agents delete <id>`

选项：--force、--json。

main 不能被删除。
如果没有 --force，则需要交互式确认（在非 TTY 会话中会失败；请使用 --force 重新运行）。
工作区、智能体状态和会话转录目录会移到废纸篓，而不是硬删除。
当 Gateway 网关可访问时，删除会通过 Gateway 网关路由，因此配置和会话存储清理会与运行时流量共用同一个写入方。如果 Gateway 网关不可访问，CLI 会回退到离线本地路径。
如果另一个智能体的工作区是同一路径、位于此工作区内，或包含此工作区，则会保留该工作区，并且 --json 会报告 workspaceRetained、workspaceRetainedReason 和 workspaceSharedWith。

路由绑定

使用路由绑定将入站渠道流量固定到特定智能体。如果你还希望每个智能体具有不同的可见技能，请在 openclaw.json 中配置 agents.defaults.skills 和 agents.list[].skills。见 Skills 配置和配置参考。列出绑定：

openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json

添加绑定：

openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a

你也可以在创建智能体时添加绑定：

openclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:* --bind discord:*

如果省略 accountId（--bind <channel>），OpenClaw 会从插件设置钩子、强制账号绑定或渠道已配置的账号数量中解析它。如果对 bind 或 unbind 省略 --agent，OpenClaw 会以当前默认智能体为目标。

`--bind` 格式

格式	含义
`--bind <channel>:*`	匹配该渠道上的所有账号。
`--bind <channel>:<account>`	匹配一个账号。
`--bind <channel>`	仅匹配默认账号，除非 CLI 可以安全解析插件特定的账号范围。

绑定范围行为

没有 accountId 的已存储绑定仅匹配渠道默认账号。
accountId: "*" 是渠道范围的回退（所有账号），其优先级低于显式账号绑定。
如果同一智能体已经有一个没有 accountId 的匹配渠道绑定，而你稍后使用显式或已解析的 accountId 进行绑定，OpenClaw 会就地升级该现有绑定，而不是添加重复项。

示例：

# match all accounts on the channel
openclaw agents bind --agent work --bind telegram:*

# match a specific account
openclaw agents bind --agent work --bind telegram:ops

# initial channel-only binding
openclaw agents bind --agent work --bind telegram

# later upgrade to account-scoped binding
openclaw agents bind --agent work --bind telegram:alerts

升级后，该绑定的路由范围限定为 telegram:alerts。如果你还需要默认账号路由，请显式添加它（例如 --bind telegram:default）。移除绑定：

openclaw agents unbind --agent work --bind telegram:ops
openclaw agents unbind --agent work --all

身份文件

每个智能体工作区都可以在工作区根目录包含一个 IDENTITY.md：

示例路径：~/.openclaw/workspace/IDENTITY.md
set-identity --from-identity 从工作区根目录（或显式 --identity-file）读取。

头像路径会相对于工作区根目录解析，并且即使通过符号链接也不能逃逸出该目录。

设置身份

set-identity 会将字段写入 agents.list[].identity：name、theme、emoji、avatar（工作区相对路径、http(s) URL 或 data URI）。

--agent 或 --workspace 选择目标智能体。如果 --workspace 匹配多个智能体，命令会失败并要求你传入 --agent。
本地工作区相对头像图片文件限制为 2 MB。HTTP(S) URL 和 data: URI 不受本地文件大小限制检查。
如果未提供显式身份字段，命令会从 IDENTITY.md 读取身份数据。

从 IDENTITY.md 加载：

openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity

显式覆盖字段：

openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png

配置示例：

{
  agents: {
    list: [
      {
        id: "main",
        identity: {
          name: "OpenClaw",
          theme: "space lobster",
          emoji: "🦞",
          avatar: "avatars/openclaw.png",
        },
      },
    ],
  },
}

​openclaw agents

​示例

​命令接口

​agents list

​agents add [name]

​agents bindings

​agents bind

​agents unbind

​agents set-identity

​agents delete <id>

​路由绑定

​--bind 格式

​绑定范围行为

​身份文件

​设置身份

​相关