Name: 🦞 企微多机器人同时接入 OpenClaw：accounts 多账号 + bindings 路由全教程
Author: Tech蜗牛

从 1 个到 N 个：企微多机器人同时接入 OpenClaw

目标是让一个 OpenClaw 实例同时挂多个企微机器人（WebSocket 长连接），各自绑定独立的 agent，按机器人隔离会话/上下文，分别服务不同部门（销售、技术、财务…）。

环境：openclaw.json + 官方 @wecom/wecom-openclaw-plugin（本文实战版本 20206.7.201）。

多机器人接入总览

一、核心思路：accounts 多账号 + bindings 路由

官方插件的单账号写法是顶层 channels.wecom 直接放一套 botId + secret，只能服务一个机器人。要接多个，必须升级为 accounts 多账号结构，并用 bindings 把每个账号路由到独立 agent。

{
  "channels": {
    "wecom": {
      "connectionMode": "websocket",
      "defaultAccount": "sales",
      "accounts": {
        "sales":    { "name": "辉火云管家", "botId": "…", "secret": "…" },
        "ev":       { "name": "EV",         "botId": "…", "secret": "…" },
        "sherlock": { "name": "夏洛克",      "botId": "…", "secret": "…" }
      },
      "bindings": [
        { "agentId": "main",        "match": { "channel": "wecom", "accountId": "sales" } },
        { "agentId": "huo15-coder", "match": { "channel": "wecom", "accountId": "ev" } },
        { "agentId": "lisa",        "match": { "channel": "wecom", "accountId": "sherlock" } }
      ]
    }
  }
}

关键点：accounts.<id> 覆盖顶层同名字段，每个机器人有独立 botId/secret；bindings 决定"哪个账号 → 哪个 agent"。defaultAccount 是未命中 bindings 时的兜底。

配置结构

二、单账号 → 多账号迁移步骤

建机器人：企微管理后台 → 应用管理 → 智能机器人 → API 模式，逐个创建，拿到每个机器人的 botId + secret。
改配置：把原顶层 channels.wecom.botId/secret 迁入 accounts.<id>，并清空顶层（避免与默认账号冲突）。顶层 agent（自建应用）、dynamicAgents、allowFrom、welcomeText 等保留不变。
备份 + 校验：改前 cp openclaw.json openclaw.json.bak-<日期>；改后用 python3 -c "import json;json.load(open('openclaw.json'))" 确认 JSON 合法。
重启生效：openclaw config validate → openclaw gateway restart → openclaw gateway status（期望 RPC probe OK，多账号都在线）。

接入流程速查

三、验证路由（最关键）

分别给每个机器人发一条消息，期望各回各 agent：

给「夏洛克」发 → 由 lisa 回复
给「EV」发 → 由 huo15-coder 回复
给「原机器人」发 → 由 main 回复

用日志确认按 accountId 路由归属：

openclaw logs tail --filter wecom

四、避坑与经验

⚠️ 官方插件多账号 bindings 可能路由失效：官方社区已有多位用户反馈——多个机器人全部落到默认 agent（main），按 accountId 绑定独立 agent 的路由在该版本/场景可能不生效；甚至新增一个长连接机器人后原有回调机器人也可能失效。落地前务必先在测试机验证路由，不要直接在生产叠加。
扫码工具不能逐个添加多机器人：官方一键扫码 @wecom/wecom-openclaw-cli install 是「覆盖式配置」默认账号，不是「扫码追加多机器人」；多账号目前主要靠手工编辑 openclaw.json。
凭据安全：botId/secret 属于敏感凭据，只写进本地 openclaw.json（600），不得 commit 进仓库。
兜底方案：若官方 bindings 确认不生效，可退回「单机器人 + Dynamic Agent / 群路由」实现按部门隔离，稳定性优先；或评估第三方多账号 fork（非官方，需权衡版本维护成本）。

本文由 @Tech蜗牛发布于聚星逸 AI 评测广场，配置基于 2026-08-24 实机验证。如需交流欢迎评论区留言。