Wechat Connect

一键安装 OpenClaw 微信插件并完成账号配对，用户全程无需接触命令行。

触发方式

• - 用户说安装微信插件
• 用户说连接微信
• 用户说微信扫码
• 用户说类似装一下微信的表达

前置条件

1. 1. OpenClaw 已安装并运行
2. qrcode npm 包已安装（workspace 已包含）
3. 微信插件包 @tencent-weixin/openclaw-weixin 未安装时，skill 会自动执行以下命令进行安装：

完整流程

用户触发
│
├─ ① 检查插件安装状态
│ 查询 openclaw.json plugins.installs
│ 已安装 → 直接进入扫码流程
│ 未安装 → 自动执行安装
│
├─ ② 获取微信登录二维码
│ 调用微信 API:
│ GET https://ilinkai.weixin.qq.com/ilink/bot/getbotqrcode?bot_type=3
│ 提取 qrcodeimgcontent，用 qrcode 库生成 PNG
│
├─ ③ 生成引导页
│ 生成 HTML：5 步骤横向展示 + 实时状态
│ 第一步至第四步为文字说明，第五步为二维码
│ 步骤：001→002→003→004→[二维码]
│ 每张图下方标注第一步~第五步
│
├─ ④ 启动本地 HTTP 服务
│ 端口 8765，提供静态文件 + 状态 API
│ 通过 browser 工具打开 http://localhost:8765
│
├─ ⑤ 状态轮询
│ 每 3 秒调用微信 API 检查扫码状态:
│ GET https://ilinkai.weixin.qq.com/ilink/bot/getqrcodestatus?qrcode=xxx
│ 状态: wait → scaned → confirmed / expired
│ 页面底部实时文字反馈
│
├─ ⑥ 成功弹窗
│ confirmed 时：灯箱弹出
│ 🎉 恭喜！微信与 OpenClaw 已经配对成功
│ 灯箱常驻，不可关闭，为最终状态
│
└─ ⑦ 保存账号
连接成功后：
- 写入 ~/.openclaw/openclaw-weixin/accounts/{id}.json
- 更新 ~/.openclaw/openclaw-weixin/accounts.json 索引
- openclaw config set channels.openclaw-weixin.enabled=true
- openclaw config set channels.openclaw-weixin.dmPolicy=allowlist
- openclaw config set channels.openclaw-weixin.allowFrom=[]
- Gateway 在后台自动重启（无需手动操作）
- 灯箱页面保持展示，重启完成后可直接使用微信测试

expired（过期）：提示重新生成，页面刷新继续
超时（5分钟）：提示超时，需重新发起

技术方案

文件结构

skills/wechat/
├── SKILL.md # 本文件
└── scripts/
└── start.mjs # 主入口脚本

依赖

• - qrcode npm 包（cd /Users/ethan/.openclaw/workspace && npm install qrcode）
• @tencent-weixin/openclaw-weixin 插件包（通过 openclaw-weixin-cli 安装）
• Node.js 18+

状态码

注意事项

• - 二维码有效期 5 分钟，超时需重新生成
• 灯箱弹出后不可关闭，为最终状态
• 账号 token 必须与 ilinkbotid 匹配，否则 session 验证失败
• 若扫码后 session 过期（errcode -14），需重新扫码认证

安全说明

⚠️ 安装微信插件时，npm 会显示以下警告（来自插件自身，非 skill 问题）：

WARNING: Plugin openclaw-weixin contains dangerous code patterns:
Environment variable access combined with network send

这是因为插件需要访问环境变量和网络发送能力，属于正常设计。安装完成后警告可忽略，插件正常运行。