OpenClaw 终于升上 v2026.3.22,但真正的雷现在才开始:微信、企业微信、飞书、钉钉、qqbot新版的各种兼容性问题

先看升级完后的效果图：

很多人这两天折腾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	可以规范重装
QQ Bot	外部插件	channels.qqbot	可以规范重装
飞书	内置 bundled 插件	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 这一步，主程序升级已经不是最麻烦的事了。真正折磨人的，是插件兼容性开始分层。先保状态，再分流处理；先救得活的，再碰兼容性的。

下一篇可以直接接：《OpenClaw v2026.3.22 插件迁移命令行清单及修复》