OpenClaw 配置多 Agent、多 QQ 及飞书机器人指南

这里 personal-bot 和 work-bot 是我们自定义的账号 ID，后续在绑定规则中会用到。

配置多 Agent

每个 Agent 对应一种人格或功能。例如我们可以创建两个 Agent：

• shuying-finance：金融助手，负责处理投资咨询
• shuying-general：通用助手，负责日常闲聊

Agent 配置示例：

{"agents":{"list":[{"id":"shuying-finance","name":"金融助手","workspace":"/data/workspace/finance"},{"id":"shuying-general","name":"通用助手","workspace":"/data/workspace/general"}]}}

每个 Agent 的工作区是独立的，可以放置不同的人格设定文件（SOUL.md）和技能代码。

配置绑定规则：将 QQ 账号路由到不同 Agent

现在我们将两个 QQ 机器人分别绑定到不同的 Agent。注意，在匹配 QQ 通道时，我们使用 accountId 字段来指定具体的机器人账号。

{"bindings":[{"agentId":"shuying-finance","match":{"channel":"qqbot","accountId":"work-bot"}},{"agentId":"shuying-general","match":{"channel":"qqbot","accountId":"personal-bot"}}]}

易错提醒：字段名必须是 accountId，而不是 account。如果写成 "account": "..." 会导致 Invalid input 错误。

配置飞书通道与绑定规则

飞书通道的配置与 QQ 略有不同。首先在 channels.feishu 中配置应用账号：

{"channels":{"feishu":{"enabled":true,"accounts":{"finance-feishu":{"appId":"FEISHU_APPID","appSecret":"FEISHU_SECRET"}}}}}

飞书绑定规则的关键区别在于：飞书的消息来源需要指定具体的 peer（对话对象），可以是用户私聊（user）或群聊（group），并给出对应的 ID。

例如，我们希望将某个飞书群的会话路由给金融助手：

{"bindings":[{"agentId":"shuying-finance","match":{"channel":"feishu","accountId":"finance-feishu","peer":{"kind":"group","id":"oc_582b57e290ba8a4d662eedaa0f446eb7"}}}]}

如果需要匹配某个用户的私聊，则将 kind 改为 user，id 改为用户的 open_id。

为什么飞书不使用 accountId 直接匹配？

因为飞书通道支持在同一应用账号下区分不同的会话来源（群或用户），提供更精细的路由控制。如果你希望某个飞书应用账号的所有消息都交给同一个 Agent，可以省略 peer 字段。

进阶：同一个 Agent 同时处理 QQ 和飞书

如果希望一个 Agent（例如 shuying-finance）既能处理 QQ 消息，也能处理飞书消息，只需添加两条绑定规则，指向同一个 agentId。

完整绑定示例：

{"bindings":[// QQ 绑定{"agentId":"shuying-finance","match":{"channel":"qqbot","accountId":"work-bot"}},{"agentId":"shuying-general","match":{"channel":"qqbot","accountId":"personal-bot"}},// 飞书绑定（同一个金融助手）{"agentId":"shuying-finance","match":{"channel":"feishu","accountId":"finance-feishu","peer":{"kind":"group","id":"oc_582b57e290ba8a4d662eedaa0f446eb7"}}}]}

现在，无论是通过 work-bot QQ 号发来的消息，还是通过指定飞书群发来的消息，都会交给 shuying-finance 这个 Agent 统一处理。Agent 将使用同一套人格和技能进行回复，实现跨平台的一致性体验。

配置文件完整示例

将以上片段整合成一个完整的配置文件（仅展示关键部分）：

{"agents":{"list":[{"id":"shuying-finance","workspace":"/data/workspace/finance"},{"id":"shuying-general","workspace":"/data/workspace/general"}]},"channels":{"qqbot":{"enabled":true,"accounts":{"personal-bot":{"appId":"QQ_APPID_1","clientSecret":"QQ_SECRET_1"},"work-bot":{"appId":"QQ_APPID_2","clientSecret":"QQ_SECRET_2"}}},"feishu":{"enabled":true,"accounts":{"finance-feishu":{"appId":"FEISHU_APPID","appSecret":"FEISHU_SECRET"}}}},"bindings":[{"agentId":"shuying-finance","match":{"channel":"qqbot","accountId":"work-bot"}},{"agentId":"shuying-general","match":{"channel":"qqbot","accountId":"personal-bot"}},{"agentId":"shuying-finance","match":{"channel":"feishu","accountId":"finance-feishu","peer":{"kind":"group","id":"oc_582b57e290ba8a4d662eedaa0f446eb7"}}}]}

验证与重启

修改配置文件后，建议先验证语法：

openclaw config validate 

如果没有错误，重启网关服务使配置生效：

openclaw gateway restart 

之后可以通过 openclaw status 查看 Agent 和通道的运行状态。分别用 QQ 和飞书向对应的机器人/群发送消息，测试是否被正确路由到预期的 Agent。

常见问题

1. 绑定规则不生效（QQ）：检查 accountId 是否与 accounts 中的键名完全一致（区分大小写），且字段名为 accountId 而非 account。
2. 绑定规则不生效（飞书）：确认 peer 中的 kind 和 id 正确无误，且该群或用户确实属于配置的飞书应用。
3. 通道启动失败：确认 appId/appSecret 无误，并且服务器 IP 已在对应平台的白名单中。
4. Agent 无响应：检查 Agent 的工作区是否存在有效的 SOUL.md 文件，或者是否有技能代码错误。

总结

通过本文的配置，我们实现了在一个 OpenClaw 实例中：

• 接入多个 QQ 机器人账号
• 定义多个具有不同人格的 Agent
• 将不同 QQ 账号的消息精确路由到对应的 Agent
• 将飞书特定群的消息也路由到其中一个 Agent，实现跨平台统一处理

OpenClaw 的灵活性和扩展性为构建复杂的对话系统提供了坚实的基础。掌握通道、Agent 和绑定规则的关系，你可以轻松扩展更多平台和更多智能体，打造属于自己的机器人矩阵。