夜雨聆风昨天更新了 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 对比了一下两个版本：
不只是前端 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 中，预计很快会发新版本。在那之前，用方案一或者方案二先把自己的环境修好。