OpenClaw 多机器人路由实战：多账号 JSON 与 bindings 路由完整指南

OpenClaw 多机器人路由实战多账号 JSON 与 bindings 路由完整指南【免费下载链接】openclaw-china-dockerOpenClaw 的中国IM平台整合Docker版本预装并配置了飞书、钉钉、QQ机器人、企业微信等主流中国IM软件的插件让您可以快速部署一个支持多个中国IM平台的 AI 机器人网关项目地址: https://gitcode.com/gh_mirrors/op/openclaw-china-dockerOpenClaw-China-Docker是一款预装飞书、钉钉、QQ 机器人、企业微信插件的 Docker 整合镜像帮助你快速部署支持多个中国 IM 平台的 AI 机器人网关。本文带你玩转它的进阶能力多账号 JSON 配置 bindings 路由——让同一套网关里跑多个机器人并把不同账号的消息精准路由到不同的 AI Agent。为什么需要多机器人路由单机器人单 Agent 很快会遇到瓶颈典型场景有场景痛点路由方案工作群 客服群共用一个网关不同群需要不同人设和知识库不同账号 → 不同 Agent飞书、钉钉、QQ 多平台部署每个平台多个机器人账号按channel accountId分流内部运营与外部客户隔离权限、模型、工具需分级不同 Agent 配不同模型与沙箱OpenClaw-China-Docker 提供两层能力支撑这种架构多账号 JSON 环境变量一个渠道下挂多个机器人账号bindings路由规则把渠道 账号映射到指定 Agent第一步用多账号 JSON 注册多个机器人在.env.example中四大平台各提供了一个多账号 JSON 变量推荐写法单行 JSON平台环境变量写入位置飞书FEISHU_ACCOUNTS_JSONchannels.feishu.accounts钉钉DINGTALK_ACCOUNTS_JSONchannels.dingtalk.accountsQQ 机器人QQBOT_BOTS_JSONchannels.qqbot.accounts企业微信WECOM_ACCOUNTS_JSONchannels.wecom结构参考可对照示例文件 openclaw.json.example。飞书多账号配置示例FEISHU_ACCOUNTS_JSON{default:{appId:cli_xxx,appSecret:xxx,name:OpenClaw Bot},work:{appId:cli_work_yyy,appSecret:work_secret_yyy,name:工作机器人},support:{appId:cli_support_zzz,appSecret:support_secret_zzz,name:客服机器人}}注意两个细节JSON 必须写成单行.env文件的限制账号的key 名如work、support就是后续路由要匹配的accountId钉钉 / QQ / 企业微信多账号示例钉钉账号支持独立的messageType、cardStreamingMode等参数DINGTALK_ACCOUNTS_JSON{bot_1:{clientId:your-client-id-1,clientSecret:your-client-secret-1,messageType:card,cardStreamingMode:all},bot_2:{clientId:your-client-id-2,clientSecret:your-client-secret-2,messageType:markdown}}QQ 机器人enabled控制单个 Bot 开关QQBOT_BOTS_JSON{default:{enabled:true,appId:111111111,clientSecret:secret-of-bot-1},bot2:{enabled:true,appId:222222222,clientSecret:secret-of-bot-2}}企业微信账号可绑定独立的自建应用 Agent 与 webhookWECOM_ACCOUNTS_JSON{open:{botId:aib-open-xxx,secret:secret-open-xxx,dmPolicy:open},support:{botId:aib-support-xxx,secret:secret-support-xxx,dmPolicy:pairing,agent:{corpId:wwxxxx,agentId:1000002}}} 每个平台的完整示例注释都写在了.env.example对应变量上方直接复制改造即可。第二步理解消息流转架构配置多账号后消息在网关内的流转路径如下IM 平台消息 → 渠道插件feishu/dingtalk/qqbot/wecom → 识别 channel accountId → bindings 路由规则匹配 → 命中对应 Agent独立模型/工作空间/工具权限关键认知没有 bindings 时所有账号的消息都会落到默认 Agent。bindings 的存在才让哪个机器人说话就交给哪个 Agent 回答成为可能。第三步bindings 路由规则深度解析如果你要把不同账号路由到不同 Agent需要手动维护宿主机上的~/.openclaw/openclaw.json参考结构 openclaw.json.example组合使用三个节点agents.list定义多个 Agentbindings定义channel accountId → agentId路由规则channels.平台.accounts对应平台的多账号配置bindings 典型写法bindings: [ { type: route, agentId: main, match: { channel: feishu, accountId: default } }, { type: route, agentId: support-agent, match: { channel: feishu, accountId: support } }, { type: route, agentId: dingtalk-ops, match: { channel: dingtalk, accountId: bot_1 } } ]路由匹配三条铁律channel必须写具体渠道名feishu/dingtalk/qqbot/wecom之一accountId必须与channels.channel.accounts下的 key 完全一致区分大小写例如上文的bot_1、supportagentId必须指向agents.list中已定义的 Agent否则会路由失败⚠️ 关键关闭配置自动同步手动维护openclaw.json后务必在.env中设置SYNC_OPENCLAW_CONFIGfalse否则会启动时启动脚本 init.sh 根据环境变量同步配置覆盖你手动写的bindings等节点。详见 docs/configuration.md 中IM 渠道多账号 / 多机器人配置一节的说明。验证与故障排查1. 重启容器并观察日志docker compose up -d --force-recreate docker compose logs -f openclaw-gateway重点搜索以下关键词来自 docs/faq.md渠道同步—— 多账号是否被正确解析已根据 ... 多账号环境变量启用插件—— 插件因多账号 JSON 被启用已禁用渠道/未提供环境变量—— 渠道被自动禁用2. 多账号配置常见报错启动脚本会自动校验多账号 JSON常见报错及原因报错原因解决FEISHU_ACCOUNTS_JSON 不是合法 JSONJSON 语法错误多行、缺引号压缩为单行用 JSON 校验工具检查飞书 App ID 冲突多个账号用了同一个appId确保各账号标识唯一钉钉 clientId 冲突多账号clientId重复同上企业微信 botId 冲突多账号botId重复同上3. 修改配置不生效怎么办进入容器检查实际生效的配置docker compose exec openclaw-gateway /bin/bash su node cat ~/.openclaw/openclaw.json若发现旧配置残留可删除openclaw.json后重启让其重新生成更完整的排查流程见 docs/faq.md。新手上手清单 ✅☐ 准备各平台的多个机器人凭证飞书 App ID/Secret、钉钉 clientId/Secret 等☐ 在.env中填入*_ACCOUNTS_JSON/QQBOT_BOTS_JSON单行 JSON☐ 执行docker compose up -d --force-recreate日志确认多账号同步成功☐ 手动维护~/.openclaw/openclaw.json定义agents.listbindings☐ 设置SYNC_OPENCLAW_CONFIGfalse防止自动同步覆盖手动配置☐ 分别向各机器人发消息验证路由到预期 Agent参考资料文档内容docs/configuration.md多账号环境变量与 bindings 完整说明docs/faq.md多账号 JSON 报错与渠道排查docs/quick-start.md部署、日志查看与升级openclaw.json.example最终生成的配置结构参考.env.example全部环境变量及多账号 JSON 示例注释掌握多账号 JSON 与 bindings 路由后一个 OpenClaw-China-Docker 网关即可承载飞书、钉钉、QQ、企业微信的多机器人矩阵并按账号粒度精细化分配 AI Agent 的能力与权限。【免费下载链接】openclaw-china-dockerOpenClaw 的中国IM平台整合Docker版本预装并配置了飞书、钉钉、QQ机器人、企业微信等主流中国IM软件的插件让您可以快速部署一个支持多个中国IM平台的 AI 机器人网关项目地址: https://gitcode.com/gh_mirrors/op/openclaw-china-docker创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考