使用微信官方 ClawBot 插件安全接入openclaw，无需逆向、不封号，手机微信升级到最新版即可，全程 5 分钟完成。

一、微信版本要求（必须）

• iOS：8.0.70+

• 安卓：8.0.69+

查看路径：微信 → 我 → 设置 → 关于微信。

如低于上述版本，在应用商店更新并重启微信。

二、手机微信启用 ClawBot 插件

1. 打开微信 → 我 → 设置

2. 下滑进入 插件

3. 在列表找到 ClawBot（龙虾）

   • 找不到：先更新微信到最新版、重启；仍无则等待官方灰度放量。

4. 进入详情页 → 启用插件，按提示完成授权。

授权仅建立通信通道，不会读取历史聊天记录与通讯录。

三、电脑端openclaw所在设备终端安装微信插件并绑定

1. 安装官方插件（终端执行）

npx -y @tencent-weixin/openclaw-weixin-cli@latest install

• 国内慢：先换源

npm config set registry https://registry.npmmirror.com

2. 生成绑定二维码 首次安装插件后不需要执行

openclaw channels login --channel openclaw-weixin

3. 微信扫一扫扫码绑定

二维码有效期约 5 分钟，过期重跑 login 命令即可。

四、验证是否成功

访问 OpenClaw 的后台，查看频道，看到微信已经部署好了:

微信进入 ClawBot 聊天窗口，发送任意消息（如“你好”），收到回复即正常。

查看通道状态（无报错写法）：

openclaw channels status

正常会看到类似：

- openclaw-weixin: enabled, configured, running

五、常用命令（直接复制可用）

# 查看通道状态
openclaw channels status

# 重启微信通道
openclaw channels logout --channel openclaw-weixin
openclaw channels login --channel openclaw-weixin

# 查看日志（排错）
openclaw channels logs --channel all

# 模型连通性测试
openclaw models test 你的模型名

六、常见问题

1. 提示 unknown option ‘–channel’

• 写法错误：status 不要加 --channel，直接用：

openclaw channels status

2. 提示 plugins.allow is empty

• 为无害警告，可忽略；想消除执行：

openclaw config set plugins.allow '("openclaw-weixin")'

3. 微信里找不到 ClawBot

• 升级微信到 iOS≥8.0.70 / 安卓≥8.0.69 并重启。

• 仍无：执行绑定命令，扫码后会引导安装；或等待灰度放量。

4. 绑定成功但无回复

• 检查模型配置与 API Key 是否有效。

• 重启微信通道，等待 1–3 分钟再试。

七、安全与隐私

• 只用官方 ClawBot 插件，不要用第三方协议库，降低封号风险。

• 数据默认本地存储（~/.openclaw/），不上云。

• 目前仅支持私聊，一个微信只能绑定一个实例。

八、总结

只要把手机微信更到最新版（iOS 8.0.70+ / 安卓 8.0.69+），启用 ClawBot，电脑执行一行安装命令、扫码绑定，即可快速接入。日常查看状态、重启通道用上面精简命令即可。