OpenClaw v2026.3.22破坏性升级：旧版插件不兼容 必须重装 注意事项【解答】

OpenClaw v2026.3.22版本因彻底替换插件接口且未提供兼容层，导致旧插件全部失效、控制台无法启动；其打包错误还造成UI模块缺失，需清除残留数据后重装v2026.3.23或更高版本修复。

OpenClaw v2026.3.22版本发布后，大量用户发现已安装的旧版插件全部失效，控制台无法启动，飞书等最新插件报“Cannot find module 'openclaw/plugin-sdk'”，根本原因是插件接口被彻底替换且未提供兼容层。

确认是否已中招

执行 openclaw --version，若输出为 【v2026.3.22】，再运行 openclaw health： 若看到 [plugins] xxx failed to load 或 Error: Cannot find module './ui/console'，说明已触发本次升级事故。

注意：该版本安装包存在打包错误，【控制台模块缺失是独立问题，与插件失效无关但同时发生】。

彻底清除旧环境

第一步：停止所有 OpenClaw 进程
pkill -f openclaw 或手动关闭终端中正在运行的实例。

第二步：删除残留数据目录
rm -rf ~/.openclaw
这一步必须执行——旧版插件（如 feishu-openclaw-plugin）和损坏的 UI 构建产物全藏在这里，不清空会导致新版加载器反复尝试加载废弃结构而报错。

第三步：卸载全局 CLI（如为 npm 全局安装）
npm uninstall -g openclaw
验证：which openclaw 应无输出，openclaw --version 应提示 command not found。

重装 v2026.3.23 或更高稳定版

方法一：使用 npm 安装修复版（推荐国内用户）
npm install -g [email protected] --registry=https://registry.npmmirror.com
该版本已修复打包错误，包含完整控制台模块，并恢复 ClawHub 访问限流策略。

方法二：从源码构建（适合开发者）
克隆最新仓库 → pnpm install → pnpm build → pnpm ui:build
【务必执行 ui:build，否则 Web 管理界面仍为空白】。

方法三：云服务一键部署（免运维）
登录腾讯云/阿里云/OpenClaw 中国镜像站 → 选择 v2026.3.31 或更高版本 → 点击「极简部署」→ 自动完成环境初始化与插件中心配置。

迁移飞书插件的唯一正确路径

旧版飞书插件（feishu-openclaw-plugin）与新版（openclaw-lark）不是覆盖关系，而是迁移关系。

① 确保 OpenClaw 主程序已升级并成功启动；
② 执行最新迁移命令：openclaw plugin install @larksuit/openclaw-lark --migrate-from feishu-openclaw-plugin；
③ 运行 openclaw lark setup 重新完成飞书企业自建应用鉴权流程；
④ 检查 openclaw health 中 Feishu 状态变为 ✅ healthy。

跳过第②步直接手动安装 openclaw-lark 会导致 plugin id mismatch，飞书消息链路永久中断。