微信 ClawBot 插件接入个人微信及 Windows 安装避坑指南
近日,微信官方在插件页面悄然上线了 ClawBot。这一更新标志着开源 AI 助手 OpenClaw(GitHub 32 万星)正式打通了个人微信的连接通道。与以往需要企业微信或第三方协议不同,这是微信原生支持的插件方案。
什么是 ClawBot?
OpenClaw 是一个强大的开源 AI 助手,能够操作电脑、运行脚本、读写文件和控制浏览器。过去最大的痛点在于必须坐在电脑前才能使用。ClawBot 的出现解决了移动端控制的问题:
- 无需公网服务器:本地部署即可。
- 无需企业微信:直接连接个人微信。
- 无需复杂 API Key:通过微信插件机制自动鉴权。
前置条件
在开始之前,请确保满足以下环境要求:
- 本地已安装 OpenClaw:如果尚未安装,建议先完成基础环境的搭建。
- 微信版本:iOS 版微信需更新至 8.0.70 及以上版本。
- 入口位置:微信 -> 我 -> 设置 -> 插件。
注意:更新微信后若未立即显示插件,请尝试完全退出并重启微信应用。
安装步骤
Mac 用户
Mac 环境下配置相对简单,官方提供了一行命令即可完成安装:
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
执行后会自动弹出二维码,扫码即可绑定。
Windows 用户(重点避坑)
Windows 环境下直接使用 npx 容易遇到报错,主要原因在于 weixin-cli 内部调用了 Linux 特有的 which 命令来检测 OpenClaw 是否安装,而 Windows PowerShell 默认不支持该指令,导致始终报"未找到 openclaw"。
推荐采用以下步骤进行安装:
第一步:使用 OpenClaw 自带命令安装插件
openclaw plugins install "@tencent-weixin/openclaw-weixin"
第二步:修复配置
运行诊断工具自动处理配置迁移和清理孤儿文件:
openclaw doctor --fix
当终端输出 Doctor complete. 时,表示配置正常。
第三步:微信扫码登录
openclaw channels login --channel openclaw-weixin
终端会生成一个二维码。打开微信"扫一扫"扫描即可。二维码有效期较短,过期会自动刷新(最多 3 次)。
第四步:重启网关
为了让插件正式生效,需要重启 gateway:
openclaw gateway restart
第五步:安全白名单配置
安装过程中可能会弹出黄色警告,提示插件涉及环境变量和网络发送行为。这是微信插件的正常操作。如需消除警告,可在 openclaw.json 中添加白名单:
{
"plugins":


