核心功能
Weixin OpenClaw Login 是腾讯官方提供的微信个人号接入 OpenClaw 框架的标准化工具集,涵盖从安装配置到故障排查的全链路支持。
核心用法
1. 安装与初始化:通过 npx -y @tencent-weixin/openclaw-weixin-cli install 快速部署官方 CLI 工具
2. 二维码获取:提供 scripts/get-login-url.js 脚本,直接提取浏览器可打开的二维码授权页面 URL,规避终端字符二维码的兼容性痛点
3. 状态轮询:通过 scripts/poll-login-status.py <qrcode> 实时追踪扫码进度,支持 wait/scaned/confirmed 三态流转
4. 故障修复:针对微信 8.0.70+ 版本的 SETUP / no token 卡住问题,提供本地状态文件检查路径及 gateway 重启方案
显著优点
- 官方背书:基于
ilinkai.weixin.qq.com域名,调用腾讯 ilink 标准接口 - 双模式支持:既有自动化脚本封装,也保留纯命令行兜底方案
- 状态透明:明确暴露
bot_token、ilink_bot_id等核心字段,便于二次集成 - 本地化存储:token 落盘到
~/.openclaw/openclaw-weixin/目录,支持多账号隔离
潜在局限
- 版本敏感:明确标注微信 8.0.70+ 为适配边界,旧版本可能行为差异
- 依赖 Node/Python:脚本执行环境需预装运行时
- 无 GUI:纯 CLI 交互,对非技术用户门槛较高
- 地域限制:ilink 域名暗示中国大陆服务范围,海外网络可能受限
适合人群
- OpenClaw 框架开发者与运维人员
- 需要将微信个人号接入 Bot 生态的技术团队
- 熟悉 Node.js/Python 及命令行操作的工程师
常规风险
- token 泄露:本地
accounts.json包含敏感凭证,需确保~/.openclaw目录权限控制 - 扫码劫持:二维码链接
qrcode_img_content需通过安全渠道传输,避免中间人拦截 - 状态不同步:腾讯侧
confirmed与 OpenClaw 本地OK存在异步窗口,强行中断可能导致重复登录 - 账号封禁:个人号频繁调用 Bot 接口可能触发微信风控策略