WeCom Connect Skill
适用场景
当用户要求连接企业微信、绑定企微机器人、创建新的企微机器人、给 OpenClaw 接入企业微信、或明确提到"扫码绑定企微"时,直接使用本流程。
核心原则
- 不生成 PNG,不走 CDN。generate 拿到
auth_url 后直接给用户,用户把链接发到企业微信聊天里点开完成授权。
- 不要自动开轮询。给完链接等用户说"配好了"再轮询。
- 不要手动卸载/禁用插件。
执行流程(写死,照抄执行)
第 1 步:调用 generate 接口
curl -s "https://work.weixin.qq.com/ai/qc/generate?source=wecom-cli&plat=3"
从返回值提取 scode 和 auth_url。scode 留着后面轮询用,auth_url 直接给用户。
第 2 步:把 auth_url 给用户,等用户回复
## 企业微信二维码
复制下面的链接,发到你的企业微信任意聊天里,然后点击打开:
<auth_url>
**操作步骤:**
1. 打开手机上的 **企业微信 App**(不是微信)
2. 随便找一个聊天对话框,把上面的链接通过发消息的方式发过去
3. 点击消息里的链接,在企业微信内打开
4. 在页面中完成授权确认
5. **配置完成后告诉我**
有效期:3 分钟
然后停下来,等用户说"配好了"。
用户确认后:轮询 + 写配置
用户说"配好了 / 扫完了 / done / ok"后:
curl -s "https://work.weixin.qq.com/ai/qc/query_result?scode=<scode>"
轮询间隔 3 秒,超时 3 分钟。成功条件:data.status === 'success' 且 data.bot_info.botid 和 data.bot_info.secret 存在。
拿到后写入 ~/.openclaw/openclaw.json:
channels.wecom.botId = <botId>
channels.wecom.secret = <secret>
channels.wecom.enabled = true
然后 openclaw gateway restart。
超时则重新走第 1~2 步。
成功回复模板
## 企业微信连接结果
- 状态:已绑定成功
- 机器人凭证:已获取(botId: `<botId>`)
- OpenClaw 配置:已写入
- Gateway:已重启
绝对禁止
- 禁止生成 PNG / 走 CDN / Batch Upload:直接给 auth_url 链接。
- 禁止自动开轮询:等用户说"配好了"。
- 禁止手动卸载/禁用插件。
一句话总结
generate → 给用户链接 → 用户发到企业微信聊天里点开授权 → 等用户说"配好了" → 轮询 → 写配置。