企业微信和QQ机器人怎么接入?OpenClaw多通道配置指南

12 人参与

在企业级协同平台中,企业微信和QQ往往被视作两条互补的沟通渠道。OpenClaw 通过统一的通道框架,让这两者可以在同一实例里并行工作,既避免了重复部署,又保持了模型调用的一致性。下面从实战角度拆解每一步的关键配置,让读者可以直接在自己的服务器上复现。

企业微信和QQ机器人怎么接入?OpenClaw多通道配置指南

企业微信接入要点

  • 在企业微信管理后台创建自建应用,记录 CorpIDSecret,确保已勾选“获取企业成员信息”和“发送消息”权限。

  • 登录 OpenClaw 控制台,进入“通道配置”,选择“企业微信”。将 CorpID、Secret 粘贴至对应字段,开启“使用长连接”。

  • 事件订阅页面添加必备回调:message.receiveevent.chat_enterevent.chat_quit,回调方式统一选长连接。

  • 在 OpenClaw 侧保存后,系统会自动拉起长连接。若出现“未建立长连接”,检查密钥是否拼写错误并重启 OpenClaw 网关服务。

QQ机器人接入要点

  • 前往腾讯开放平台,创建 QQ 机器人,获取 AppIDAppKey,并在“消息与事件”中打开“私聊消息”和“群聊消息”开关。

  • 在 OpenClaw 的“通道配置”里选择“QQ”,填入 AppID、AppKey,勾选“自动回复”。

  • 为机器人开启“主动推送”权限,避免在高并发场景下被风控。权限文件可在平台的“权限管理”页批量导入。

  • 保存后,OpenClaw 会尝试通过 WebSocket 与 QQ 服务器握手。若出现“连接被拒”,检查服务器公网 IP 是否已在 QQ 平台白名单中。

OpenClaw 多通道统一配置技巧

OpenClaw 采用 JSON 结构的通道清单,所有渠道可以在同一个 channels.json 文件里声明。下面的示例把企业微信和 QQ 同时写入,配合模型 API Key,便能在一次部署中实现双向对话。

{
    "model_api_key": "sk-xxxxxxxxxxxxxxxx",
    "channels": [
        {
            "type": "wechat_work",
            "corp_id": "ww1234567890abcdef",
            "secret": "abcd1234efgh5678ijkl9012mnop3456"
        },
        {
            "type": "qq",
            "app_id": "123456789",
            "app_key": "abcdef1234567890abcdef1234567890"
        }
    ]
}

实际运行时,只需在服务器根目录执行 ./openclaw --config channels.json,系统会并行启动两条长连接。值得注意的是,模型调用的并发阈值应统一设定,否则某一渠道的高峰请求可能抢占全部算力,导致另一渠道响应变慢。把模型并发上限写在 model.yaml 里,配合 OpenClaw 的“限流插件”,即可实现流量自适应。

参与讨论

12 条评论