目录
OpenClaw 多 Agent CLI 配置与 Channel 绑定指南
如果你希望 OpenClaw 不只是一个单体助手,而是变成一个“多工种小队”,那么 agents 相关的 CLI 命令就非常值得用起来。
你可以为不同职责创建不同 Agent,比如:
research负责检索和调研coder负责写代码和改项目analyst负责分析和总结
然后再把它们绑定到不同消息通道,让不同入口直接连接到不同 Agent。这样整个系统会清晰很多,不会一只脑袋硬扛所有活。
一、添加 Agent
使用 openclaw agents add <name> 可以新增一个 Agent,并指定它的工作目录和模型。
示例 1:创建 research Agent
openclaw agents add research --workspace ~/.openclaw/workspace-research --model anthropic/claude-sonnet-4-6
这个命令会创建一个名为 research 的 Agent:
research:作为位置参数传入的 Agent 名称--workspace ~/.openclaw/workspace-research:该 Agent 的独立工作目录--model anthropic/claude-sonnet-4-6:该 Agent 默认使用的模型
示例 2:创建 coder Agent
openclaw agents add coder --workspace ~/.openclaw/workspace-coder --model openai/gpt-5.4
这个 Agent 更适合承担代码编写、项目调试、自动化改造等任务。
示例 3:创建 analyst Agent
openclaw agents add analyst --workspace ~/.openclaw/workspace-analyst
如果没有显式指定 --model,通常会使用默认模型配置。
二、查看当前 Agent 列表
创建完成后,可以用下面的命令查看当前 Agent 列表以及绑定关系:
openclaw agents list --verbose --bindings
这个命令通常可以帮助你快速确认:
- 当前系统里有哪些 Agent
- 每个 Agent 的 workspace 在哪里
- 使用的默认模型是什么
- 它已经绑定到了哪些 channel 或 account
如果你正在搭一个多 Agent 架构,这条命令基本就是每日巡检入口。
三、绑定 Agent 到 Channel
创建好 Agent 之后,如果你希望某个聊天入口直接由指定 Agent 处理,就需要执行绑定。
绑定到某类 channel
例如,把 newagent 绑定到 QQ:
openclaw agents bind --agent newagent --bind qq
这表示该 Agent 可以接管对应 QQ 通道的消息入口。
绑定到具体 account
如果你有多个账号,或者想精确绑定到某一个实例,可以写得更具体:
openclaw agents bind --agent newagent --bind qq:default
或者绑定到某个企业微信实例:
openclaw agents bind --agent newagent --bind openclaw-weixin:03528ca08943-im-bot
这种方式更适合:
- 多账号并行运行
- 不同业务入口路由给不同 Agent
- 同时接入 QQ、企业微信、Telegram 等多个渠道
四、一个实用的多 Agent 分工示例
下面是一套比较常见、也比较好落地的配置:
1. research Agent
openclaw agents add research --workspace ~/.openclaw/workspace-research --model anthropic/claude-sonnet-4-6
负责资料查找、网页总结、信息收集。
2. coder Agent
openclaw agents add coder --workspace ~/.openclaw/workspace-coder --model openai/gpt-5.4
负责代码修改、调试、项目开发。
3. analyst Agent
openclaw agents add analyst --workspace ~/.openclaw/workspace-analyst
负责结构化分析、报告输出、数据整理。
然后根据入口做绑定:
openclaw agents bind --agent research --bind qq
openclaw agents bind --agent coder --bind qq:default
openclaw agents bind --agent analyst --bind openclaw-weixin:03528ca08943-im-bot
这样一来,不同入口就能拥有不同“接待员”。
五、为什么推荐拆多个 Agent
把多个 Agent 分开管理,通常会带来几个直接收益:
- 职责清晰:调研、编码、分析互不打架
- 工作区隔离:每个 Agent 有自己的 workspace,不容易把项目搞混
- 模型可定制:不同任务可以分配不同模型
- 通道可路由:不同平台、不同账号可以接到不同 Agent
- 后续扩展方便:以后加
ops、blogger、assistant都很自然
对于已经接入多个聊天平台的用户来说,这种拆分几乎不是“高级玩法”,而是很快就会需要的基础能力。
六、建议的上手顺序
如果你刚开始搭多 Agent,建议先建这两个:
- 一个
coder - 一个
research
这两个已经足够覆盖大多数开发和资料整理场景。
等入口和需求再复杂一些,再继续补:
analystopsbloggerassistant
不要一开始就建十几个,不然最后你自己都容易忘了谁在干什么,直接变成赛博动物园。
七、总结
OpenClaw 的 agents CLI 让多 Agent 架构变得非常直接:
- 用
openclaw agents add <name>创建 Agent - 用
openclaw agents list --verbose --bindings查看配置 - 用
openclaw agents bind把 Agent 绑定到 channel 或 account
如果你正在做多角色协作、多消息入口接入,或者希望不同任务跑不同模型,这套方式会非常顺手。
当你的 OpenClaw 开始“分工上班”之后,整个体验通常会比单 Agent 方案清晰很多。
