OpenClaw微信通道绑定指南
TL;DR
OpenClaw微信通道绑定流程：注册角色→扫码登录微信→自动绑定accountId→验证绑定结果。核心价值是让角色通过微信接收消息，accountId识别微信账号身份。
触发场景
- 配置OpenClaw微信通道时
- 绑定新角色到微信时
- 故障排查微信绑定问题时
行动步骤
- 注册角色（如尚未注册）：openclaw agents add
- 扫码登录微信：rolectl.sh bind-weixin --login，弹出二维码后手机扫码确认
- 自动化完成：登录成功→自动识别accountId→执行bind→自动重启gateway
- 验证：rolectl.sh verify 或 openclaw agents list --bindings --json
- 已知accountId时快速绑定：rolectl.sh bind-weixin --account-id <id>
证据
微信绑定已形成完整文档，包含故障排查表（扫码后登录成功但绑定失败/verify报dmScope错误/重复绑定等）
失败边界
- 扫码后登录成功但绑定失败：重启gateway再重试
- verify报dmScope错误：执行rolectl.sh apply-guardrails修复隔离配置
- 同一accountId被重复绑定：先解绑旧角色
原理
OpenClaw的微信通道绑定本质是将微信账号身份（accountId）与角色（agent）绑定，实现消息路由。绑定后，该角色的所有cron任务输出都可以推送到对应微信账号。
使用记录
| 日期 | 项目/场景 | 结果 | 备注 |
|------|----------|------|------|
| 2026-05-17 | OpenClaw微信通道绑定 | confirmed | 绑定指南 |