微信 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"
