OpenClaw 近日发布了新版本。将系统升级到 OpenClaw 2026.3.24（cff6dc9）后，旧版微信 ClawBot 插件（1.0.3）与新架构不再兼容，需升级到 2.0.1 才能正常使用。

npm 上的 @tencent-weixin/openclaw-weixin 已完成更新发布。

一、卸载旧版微信 ClawBot 插件

由于版本不兼容，未清理旧插件会导致新版本无法安装。可先尝试命令卸载：

openclaw plugins uninstall openclaw-weixin

若卸载命令无效，请直接删除残留目录：

~/.openclaw/extensions/openclaw-weixin
~/.openclaw/openclaw-weixin

二、安装新版微信 ClawBot 插件（2.0.1）

OpenClaw 2026.3.24 对插件加载机制做了较大调整，所有插件安装需通过 ClawHub。

当前 ClawHub 存在速率限制，安装可能出现失败，请耐心重试。

方式一：Quick Install

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

若出现“速率受限制”等提示导致安装失败，请改用手动安装。

方式二：Manual Installation

安装插件：

openclaw plugins install "@tencent-weixin/openclaw-weixin"

启用插件：

openclaw config set plugins.entries.openclaw-weixin.enabled true

扫码登录微信：

openclaw channels login --channel openclaw-weixin

终端会显示二维码，用手机微信扫码并确认授权；

完成后本地自动保存凭据，无需额外配置。

重启网关：

openclaw gateway restart

三、重新绑定并验证

在终端执行：

openclaw channels login --channel openclaw-weixin

扫码绑定成功后，查看插件版本：

openclaw plugins list

确认微信插件已更新至 2.0.1。

随后进行微信消息收发测试，即可验证升级完成。

常见问题与处理

若出现插件加载失败、接口报错，多为版本不兼容或残留文件导致。建议按“清理旧残留 → 重装新版插件 → 重启服务”流程处理。

需删除的旧版本残留目录为：

~/.openclaw/extensions/openclaw-weixin
~/.openclaw/openclaw-weixin

升级后，插件加载机制与 SDK 调用方式已更新，旧版报错或安装失败属正常现象。

结语

完成以上步骤后，微信 ClawBot 将在新版 OpenClaw 架构下恢复正常消息收发与 AI 能力调用，获得更顺畅的使用体验。