核心用法
Wechat Connect 是 OpenClaw 官方提供的微信生态接入技能,专为降低技术门槛而设计。用户仅需说出"安装微信插件""连接微信"或"微信扫码"等自然语言指令,即可触发完整的自动化流程:系统先检测并自动安装 @tencent-weixin/openclaw-weixin 插件,随后调用微信 ilink API 获取登录二维码,生成本地引导页并启动 HTTP 服务(8765端口),通过浏览器工具展示含5步骤指引的可视化界面。用户微信扫码后,系统每3秒轮询状态,直至确认登录成功,最终自动保存账号配置、启用微信通道并完成 Gateway 重启。
显著优点
- 零命令行体验:全程图形化操作,非技术用户友好
- 自动化闭环:从插件安装到配置生效无需人工干预,含自动重试机制
- 实时状态可视:5步骤进度条 + 动态二维码 + 底部状态文字,反馈清晰
- 官方生态对接:直接调用
ilinkai.weixin.qq.com微信官方 API,稳定性有保障 - 配置即生效:自动写入账号索引、更新通道策略、重启 Gateway,无需手动配置
潜在缺点与局限性
- 单点依赖:强依赖微信 ilink API 可用性,若微信服务端异常则流程中断
- 端口占用:固定使用 8765 端口,若被占用需手动处理
- 时效限制:二维码仅5分钟有效,超时需重新发起完整流程
- 会话脆弱性:扫码后 session 可能过期(errcode -14),需重复认证
- 灯箱不可关闭:成功状态页常驻,可能干扰后续操作
适合人群
- OpenClaw 新用户,希望快速启用微信消息通道
- 不熟悉 CLI 的终端用户或运营人员
- 需批量部署微信对接的企业管理员
常规风险
- 插件安装时 npm 会提示"危险代码模式"警告(环境变量+网络访问),属正常设计但可能引发安全疑虑
- 账号凭证存储于本地 JSON 文件,需确保
~/.openclaw目录权限安全 - 本地 HTTP 服务虽仅短期运行,但在公共网络环境下存在端口暴露风险