�� OpenClaw 3.22 更新了,但我劝你先别动

昨晚睡觉前手贱，看到 OpenClaw 推了新版本，不假思索就更新了一波。

然后就没有然后了——飞书没声音，微信也断了，盯着黑屏 Terminal 发呆了两个小时。

今天社区里哀鸿遍野，大家的遭遇都差不多。这篇文章我来给还没更新的朋友说清楚：3.22 到底动了什么，为什么我们这些用国内 IM 插件的人，这次先别碰。

这次更新有多大？

有多大？官方自己都说了："本次版本更新内容非常庞大，需要单独列出目录。"

OpenClaw 上次更新还是十天前的事，以前最慢也是两天一更，这次憋了十天，一下子把积压的东西全倒出来了。更新日志拉到底，密密麻麻。

一句话概括：这不是"加了一个炫功能"的版本，而是"把 OpenClaw 从一堆历史兼容和旧入口里，往更统一、更生态化、更工程化的方向硬拉了一大步"。

听起来很好。问题就在这个"硬拉"上。

这是本次事故的核心原因。

针对第三方插件，未来需要使用统一的 SDK 接口：openclaw/plugin-sdk/*，原来的 openclaw/extension-api 不再使用，开发者需要注意。

翻译成人话就是：以前插件和 OpenClaw 打交道用的"接口"，这次直接换了一套。

• 旧接口：openclaw/extension-api（废弃）

• 新接口：openclaw/plugin-sdk/*（新标准）

对于飞书、微信这些国内 IM 插件来说，它们大多是社区开发者维护的第三方插件，不可能在官方发版的同一天就完成适配。所以更新完的第一件事，就是这些插件直接挂掉了。

社区里有人总结得很准：老插件、老自定义扩展有可能需要改代码才能继续用。

除了 SDK 路径，连插件跟 OpenClaw 通信的底层机制也变了：

删除了原来的消息发现机制 listActions、getCapabilities、getToolSchema，强制统一入口改为 ChannelMessageActionAdapter.describeMessageTool(...)。

这相当于你家的门换了，但锁和钥匙全都不兼容了。插件懵了，不知道怎么跟 OpenClaw 说话，自然就断连了。

这个更直观。UI 虽然有改进（圆角、usage 页面、聊天体验更好），但大量用户反映升级之后界面直接坏了——CSS 文件、JS 文件加载不到，script/ui.js 缺失，Control UI 白屏打不开。

不是个别情况，评论区里一片"Missing"。

截图里满屏都是哀嚎：

• 有人说飞书、微信插件全挂了，回滚到 3.13 才恢复

• 有人 Control UI 完全打不开，缺 script/ui.js

• 有人说刚修完 UI 就遇到了这次更新，直呼"修不完的轮回"

• 还有人 ClawHub 一直 429，连插件都装不上去——因为大家都在同一时间重装

Dios（51 赞）在评论区提醒：

暂时不要更新 openclaw 最新版本，因为最新版本换了插件 SDK，会导致没有同步更新的 IM 插件挂掉（比如飞书）。

Justin 亲身试了：

已更新，飞书、微信插件全挂了，搞了半天只能回滚 3.13。用这两个插件的，建议等插件更新支持新版本之后再更新。

说实话，时间线我也不确定。

好消息是飞书官方插件的维护方响应很快，修复已在路上。微信插件因为维护方不同，进度会稍慢一些。

我的建议是，等以下两件事都确认再更：

1. 你在用的插件（飞书 / 微信 / 钉钉等）明确发布了"已适配 3.22 SDK"的新版本

2. 社区里有人确认更新后 Control UI 正常、插件稳定运行

在那之前，先别动。

回滚。先备份配置，再降版本：

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

# 回滚到稳定版
npm install -g openclaw@2026.3.13

这次 3.22 是一次架构迁移版本，不是普通的功能更新。插件 SDK 换代、消息接口重写，对 OpenClaw 自身的长期发展是好事——生态会更统一、插件质量会更高。

但迁移期就是阵痛期，尤其是飞书、微信这些国内 IM 插件，开发者都是社区志愿者，不可能第一时间跟上官方的破坏性变更。

新功能再好，没了 IM 接入，OpenClaw 对我们来说就是个空壳。

等插件跟上了，再更不迟。