OpenClaw 3 月 23 日(v2026.3.23)的激进更新引发了控制台空白、微信 / 飞书等插件集体失效、第三方技能大面积瘫痪等严重异常,核心原因是无兼容层的插件 API 彻底重构 + 打包失误。
毕竟是个人用户的开源产品,很难做到体系化的用户体验保障,适合用来学习研究而不是带入到生产环境中。
一、异常现象(用户侧)
- Web 控制台无法访问
页面空白 / 404,因 UI 资源未打包进 npm 包。 - 官方插件失效
微信、企业微信、钉钉、飞书等 IM 插件直接报错( Cannot find module 'openclaw/plugin-sdk')。 - 第三方技能停摆
GitHub 上数百个基于旧 API 的开源技能无法运行。 - 模型 / 配置报错
部分模型参数冲突、任务队列堆积、ClawHub 限流。 - 安全提示
微信插件提示 “检测到潜在风险代码”。
二、根本原因(技术侧)
- 破坏性重构(Breaking Change)
完全移除旧 openclaw/extension-api,强制迁移到新openclaw/plugin-sdk/*,未提供兼容垫片。 - 打包失误
控制台 UI 资源未被包含在发布包中。 - 生态未同步
大量第三方插件未完成新 SDK 适配。
三、官方修复进展
- 插件适配
微信等官方插件已发布兼容新版本。 - 社区迁移
第三方开发者逐步提交兼容代码。
四、临时解决方案(立即可用)
⚠️ 注意:官方不建议手动修复,可能导致后续升级冲突。
五、后续建议
- 生产环境
暂不升级,停留在 2026.3.13。 - 关注官方
GitHub Releases 与社区公告,获取最新修复与迁移指南。
夜雨聆风