OpenClaw v2026.3.22 更新的同学们,出来领赔偿

昨天更新了 OpenClaw 的朋友，你的 Dashboard 是不是变成白屏了？

别慌，不是你操作有问题，是官方自己翻车了。

昨天（2026年3月23日），OpenClaw 发布了 v2026.3.22 版本。结果 npm 包刚发出去，大量用户更新后发现：Control UI 的静态文件全丢了。

打开 Dashboard 看到的只有一行字：

Control UI assets not found. Build them with `pnpm ui:build`

你按提示去运行 pnpm ui:build？不好意思，这个命令也跑不了——因为连构建脚本本身也没打包进去。

官方打包的时候，把要发布的东西落在家里了。

到底发生了什么

这批 v2026.3.22 的 npm 包，缺少了 dist/control-ui/ 整个目录。

有人用 npm pack --dry-run 对比了一下两个版本：

版本	dist/control-ui/	状态
v2026.3.13	✅ 存在（47个文件）	正常
v2026.3.22	❌ 完全缺失	坏

不只是前端 UI 文件，WhatsApp 频道插件的代码也丢了——dist/extensions/whatsapp/ 同样不在包里。

官方后来的说法是：npm publish 工作流在 UI 构建完成之前就执行了，导致打包的时候少装了一整个文件夹。

影响到谁了

昨天更新到 v2026.3.22 的用户，只要你启动了 gateway，就中招了。

Dashboard 白屏，WhatsApp 频道失效，按官方提示修复还修复不了——因为它让你执行的命令本身就不存在。

GitHub 上迅速冒出了一堆 issue，光是相关的问题报告就有几十个。官方 pull request 区已经有人在修这个 bug 了，但补丁还没发出来。

怎么修（三个方案）

方案一：从旧版里拿文件（最简单）

这是最干净的方案，不需要装任何构建工具，直接从 v2026.3.13 的包里把缺失的文件复制过来：

cd /tmpnpm pack openclaw@2026.3.13tar -xzf openclaw-2026.3.13.tgzcp -r package/dist/control-ui $(npm prefix -g)/lib/node_modules/openclaw/dist/openclaw gateway restart

重启之后，Dashboard 应该就回来了。

方案二：回滚到 v2026.3.13

如果你不想折腾，最直接的办法是降级：

npm install -g openclaw@2026.3.13openclaw gateway restart

降级不会丢失你的配置，数据和设置都是独立的。

方案三：从源码构建

如果你想用最新版，又想自己修：

git clone --depth 1 https://github.com/openclaw/openclaw.git /tmp/openclaw-srccd /tmp/openclaw-srcpnpm installpnpm ui:buildcp -r /tmp/openclaw-src/dist/control-ui ~/.npm-global/lib/node_modules/openclaw/dist/openclaw gateway restart

不过这个方案需要你本地有 Node.js 环境，执行时间也长一些。

官方在干什么

好消息是：官方已经知道这个问题了，而且动作很快。

目前 GitHub 上已经有三个相关 Pull Request 在修这个 bug：

#52856：fix: ensure control-ui is built before publish (#52808) — 确保下次发布前 UI 已经构建好
#52839：fix(packaging): add Control UI build verification to prevent broken releases — 加 CI 验证
#52835：fix: catch missing packed UI canaries — 防止同类问题再次漏网

换句话说，这次是"发布流程漏检"导致的，官方已经在补流程漏洞了。下个版本发布时会有验证步骤，不会再让这种包流出去了。

这次事件教会了我们什么

大版本更新前，看看 GitHub issues。如果你更新前刷一眼 X 或 GitHub，就能看到大量用户已经在报告同样的问题。
npm 包也会翻车。不只是配置问题，npm 包本身的内容都可能不完整。
遇到白屏别急着骂自己。Dashboard 坏了不一定是你的操作问题。

目前 v2026.3.22 的问题补丁还在 review 中，预计很快会发新版本。在那之前，用方案一或者方案二先把自己的环境修好。