核心用法
Wechat Connect 是一款专为 OpenClaw 设计的微信生态接入技能。用户通过自然语言指令(如"安装微信插件"、"连接微信"或"微信扫码")即可触发完整的账号配对流程,全程无需接触命令行界面。
技能执行时会自动检测插件安装状态,未安装时引导用户执行一次性 npm 安装命令。随后调用微信 ilink 官方 API 获取登录二维码,生成本地 HTTP 服务(端口 8765)并提供可视化引导页面。页面采用五步横向流程设计,实时轮询扫码状态(wait→scaned→confirmed/expired),最终以灯箱弹窗确认配对成功,并自动完成账号配置与网关重启。
显著优点
1. 零门槛交互:完全屏蔽命令行操作,通过浏览器可视化界面完成全部流程,大幅降低技术门槛
2. 官方生态对接:直接调用微信 ilink API(ilinkai.weixin.qq.com),属于腾讯微信官方提供的机器人接入通道
3. 自动化配置:成功后自动写入账号文件、更新索引、启用通道并配置白名单,无需手动编辑配置文件
4. 实时状态反馈:3 秒轮询机制配合页面动态更新,用户体验流畅
5. 持久化存储:账号信息规范存储于 ~/.openclaw/openclaw-weixin/ 目录,便于管理
潜在缺点与局限性
1. 前置依赖较重:需预先安装 @tencent-weixin/openclaw-weixin-cli 插件包,首次使用存在额外步骤
2. 本地服务限制:HTTP 服务绑定 localhost:8765,无法远程访问,多设备场景受限
3. 超时机制严格:二维码 5 分钟有效期且不可延长,网络波动可能导致流程中断
4. 进程间通信脆弱:依赖 /tmp/weixin-login-status.json 进行状态同步,存在临时文件残留或权限问题风险
5. 插件安全警告:安装时 npm 会提示"dangerous code patterns"警告,虽属正常设计但可能引发用户疑虑
适合人群
- OpenClaw 用户希望快速接入微信生态进行自动化操作
- 不熟悉命令行但需要配置微信机器人的非技术用户
- 需要官方微信 API 稳定性的企业级应用场景
常规风险
- 会话过期风险:扫码后若 session 过期(errcode -14)需重新认证,影响自动化流程稳定性
- 账号隔离风险:token 与 ilink_bot_id 不匹配将导致验证失败,需确保账号体系一致性
- 本地端口占用:8765 端口被占用时服务启动失败,需手动排查
- 临时文件安全:/tmp 目录下的状态文件若被篡改可能导致状态误判
- 配置覆盖风险:自动执行的 openclaw config set 命令会修改全局配置,多账号场景需谨慎