乐于分享
好东西不私藏

OpenClaw升级踩坑:微信插件不兼容怎么办?

OpenClaw升级踩坑:微信插件不兼容怎么办?

最近OpenClaw发布了2026.3.24版本,不少朋友兴冲冲地升完级,结果发现微信不灵了——消息发不出去,AI也不回话了。

别慌,这不是你的问题,是插件版本没跟上

今天手把手带你把这个坑踩过去,5分钟搞定。

一、为什么升完级微信就不工作了?

简单说:新版OpenClaw改了插件加载机制,旧的微信clawbot插件(1.0.3)跟新架构不兼容,加载直接报错。

这属于正常现象,不是你操作错了。官方也很快适配了新版本插件(2.0.1),只需要重新安装就行。

二、升级四步走

第1步:清理旧版本

旧版本可能残留两个目录,必须先清理干净,否则新版本装不上:

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

直接删除这两个目录即可。如果 openclaw plugins uninstall 命令不好使,暴力删目录是OK的。

第2步:安装新版本

新版本要求所有插件必须通过 ClawHub 安装。官方给了一个快速安装命令:

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

但实际操作中,ClawHub有速率限制,一次装不上是常态,多试几次就行。

如果快速安装一直失败,可以手动执行:

code
openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true

第3步:重新绑定微信

安装完别忘了重新扫码登录:

code
openclaw channels login --channel openclaw-weixin

终端会弹出二维码,手机微信扫一扫、确认授权就行。登录凭证会自动保存本地,不用反复操作。

第4步:重启网关

最后一步,重启OpenClaw网关让插件生效:

code
openclaw gateway restart

三、验证一下

重启后,发条微信消息测试一下。如果AI正常回复,恭喜你,升级完成!🎉

也可以用命令确认插件版本:

code
openclaw plugins list

看到 openclaw-weixin 显示 2.0.x 版本就对了。

写在最后

整个升级过程其实就一句话:清理旧残留 → 重装新版插件 → 重启服务

OpenClaw这个版本改动不算小,插件生态正在快速迭代中。遇到兼容性问题很正常,跟着官方文档走就行。社区里踩过坑的人也越来越多,遇到问题多搜搜,基本都能找到答案。

如果你也在用OpenClaw + 微信,欢迎交流经验~