
先看升级完后的效果图:





很多人这两天折腾OpenClaw,第一反应还是老三样:重装主程序、重启gatway、再来一遍。
结果是,openclaw --version 明明已经到了 v2026.3.22,日志还是红的,通道还是挂的,心态也还是炸的。
问题不在主程序了。
到 2026-03-23 为止,OpenClaw主程序升级这件事,基本已经翻篇。现在真正卡人的,是插件和宿主版本之间的兼容性。
先说结论
你以为自己在修 OpenClaw,其实你在修插件。
主程序已经是 v2026.3.22 真正要处理的是五个常见通道插件 这五个插件不能按同一种方式重装 里面只有两个,能靠规范重装解决 还有两个,重装完大概率还是继续报错
先把最大的误判纠正过来
现在最容易犯的错,是把“插件兼容问题”误判成“主程序没升级好”。这两个不是一回事。
如果你看到本机 OpenClaw 已经是 v2026.3.22,那就别再围着主程序反复重装了。继续这样折腾,最多只是多制造几份日志。
真正的核心矛盾,是旧插件在新宿主上能不能正常加载。

这 5 个通道,必须拆开看
这里最容易混淆的是:
- wecom
是企业微信 - weixin
是微信
这两个不是一个插件,也不能混着处理。
| channels.dingtalk-connector | |||
| channels.wecom | |||
| channels.qqbot | |||
| channels.feishu | |||
| channels.openclaw-weixin |

企业微信:能重装,而且应该优先处理
企业微信对应插件是 @wecom/wecom-openclaw-plugin,
配置位置在channels.wecom。
推荐安装命令
openclaw plugins install @wecom/wecom-openclaw-plugin如果你当前环境里 wecom 还是旧版本,而 npm 最新已经明显往前走了,那它属于很典型的“可以通过规范重装恢复”的插件。先备份原配置,再清理旧插件,然后重装到当前最新。

QQ Bot:同样可以靠规范重装解决
QQ Bot 对应插件是 @sliverp/qqbot@latest,配置位置在 channels.qqbot。
推荐安装命令
openclaw plugins install @sliverp/qqbot@latest这类问题不要无限脑补,动作反而越简单越好:先保配置,再重装,最后做通道验证。能正常收发,就过线。

飞书:不要把内置插件当外挂删
飞书不是“你额外从 npm 装上去的外挂”,而是 openclaw@2026.3.22 当前自带的 bundled 插件。
所以飞书的正确处理方式不是“删掉再装”,而是保留内置插件,只检查 channels.feishu 配置是否完整。

微信:重装大概率还会报原错
微信插件是@tencent-weixin/openclaw-weixin,配置位置在channels.openclaw-weixin。
常见命令
npx -y @tencent-weixin/openclaw-weixin-cli installopenclaw channels login --channel openclaw-weixin
但要把话说透一点。当前微信插件报的是:
resolvePreferredOpenClawTmpDir is not a function
这类报错更像是插件还在调用旧宿主 SDK 接口。你可以重装一次做确认,但不要对“重装即可自愈”抱太大希望。

钉钉:问题也不是装坏了,而是版本没跟上
钉钉对应的安装包是 @dingtalk-real-ai/dingtalk-connector,配置位置在 channels.dingtalk-connector。
当前报错
ERR_PACKAGE_PATH_NOT_EXPORTED
如果 npm 最新还是当前版本,那你卸掉再装回“当前最新”,大概率还是同一个错。问题不在你装坏了,而在于这个插件当前发布版本本身就还没跟上新宿主。
所有配置都在哪,哪些必须先保住
真正要保的,不只是一个配置文件。主配置文件在 ~/.openclaw/openclaw.json,但如果你要做迁移,建议整体保留下面这些目录:
~/.openclaw/openclaw.json~/.openclaw/credentials/~/.openclaw/extensions/~/.openclaw/workspace/
正确的处理顺序,应该怎么走
先备份现有配置和登录状态。 优先清理并重装 qqbot、wecom。 飞书保留,只做配置校验。 再处理 weixin 和 dingtalk,把问题明确归类为“脏安装”还是“版本兼容”。 最后统一跑 openclaw plugins list 和逐个通道验证。
补充一页:四个常用通道的配置教程入口
如果你准备把这篇当成迁移主文来用,文末最好顺手把官方配置入口也放上。这样读者看完判断逻辑之后,可以直接顺着往下配,不用再自己到处找资料。
钉钉
配置参考:https://open.dingtalk.com/document/dingstart/install-openclaw-locally插件安装命令:openclaw plugins install @dingtalk-real-ai/dingtalk-connector这里最容易漏掉的一步,是先在 OpenClaw 的命令行环境里把插件装好,再继续后台配置。插件本体没装,后面参数填得再全也没用。企业微信
官方配置参考:https://open.work.weixin.qq.com/help2/pc/21657企业微信这条线相对标准,核心还是回到 channels.wecom 去核对参数。通常先确认 botId、secret、enabled,安装和加载没问题的话,按官方文档把参数补全就可以。QQ Bot
登录入口:https://q.qq.com/qqbot/openclaw/login.html配置步骤参考:https://cloud.tencent.com/developer/article/2626045QQ Bot 这边更直接。先扫码登录,把机器人加上,再把配置参数补齐。重点不在概念,而在账号、应用和参数有没有对齐。飞书
教程参考:https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh飞书这条线和前面几个通道相比,没有那么多额外分支,配置思路基本是大同小异。重点还是核对 appId、appSecret、connectionMode、allowFrom。飞书真正要注意的,依然是内置插件保留,配置项写对。最后一句判断
OpenClaw 到了 v2026.3.22 这一步,主程序升级已经不是最麻烦的事了。真正折磨人的,是插件兼容性开始分层。先保状态,再分流处理;先救得活的,再碰兼容性的。
NEXT ARTICLE
下一篇可以直接接:《OpenClaw v2026.3.22 插件迁移命令行清单及修复》
夜雨聆风