🦞OpenClaw 最新版不可用：别急着造神，先跑起来再说

这两天看了一圈 OpenClaw 新版本的文章，熟悉的味道又来了：

• • 全网等了9天
• • 新功能很强
• • 体验很炸
• • 生态很全
• • 仿佛不升级就落后版本了

结果笔者自己一升级，先等来的不是新功能，而是 WebUI 直接 503。

提示也不复杂：Control UI assets not found。

翻译成人话就是：你不能通过浏览器玩🦞了。

所以有时候真不是产品太强，而是社区太会造神。东西还没在自己机器上完整跑通，牛逼已经先吹出去了。

不是你配错了，是包发坏了

这次问题其实已经写进 PR 了：

• • PR：https://github.com/openclaw/openclaw/pull/52839
• • 标题：fix(packaging): add Control UI build verification to prevent broken releases

核心结论很简单：

• • v2026.3.22 的 npm 包缺少 dist/control-ui/
• • 结果就是 Web dashboard 无法访问
• • 对 npm 安装用户来说，这是稳定可复现的问题

所以这次不是本地配置抽风，不是升级姿势有问题，也不是“重装一下试试”就能解决。

是包本身坏了。

更幽默的是，不只是 dist/control-ui/ 没带上，连 scripts/ui.js 也没进 npm 包。也就是说，你想自己在全局安装目录里手动构建 UI，都补不。

实际影响

先说结论：

• • 受影响的主要是 WebUI / Dashboard
• • 你已经对接好的 Telegram 等工具通常不会直接受影响
• • 后端很多功能可能还活着，只是前端控制台没了

已经升级了怎么办

比较现实的几个方案：

A：从旧版 npm 包提取 dist/control-ui 补进去

这是更推荐的方案，通常最快。

思路就是：

• • 找一个正常版本的 OpenClaw npm 包
• • 提取里面的 dist/control-ui
• • 补到当前全局安装目录对应的位置

优点是：

• • 快
• • 改动小
• • 不依赖当前坏包里有没有完整构建脚本

B：从源码构建 UI，然后配置 gateway.controlUi.root

如果你手头有可工作的源码环境，也可以：

• • 在源码仓库里把 Control UI 构建出来
• • 拿到生成目录
• • 在配置里把 gateway.controlUi.root 指过去

这个方案更灵活，但也更折腾，更适合本来就在捣鼓源码的人。

C：等

如果你不急，也不想手工补文件，那最省事的办法就是等下一个正式修复版。

个人见解

普通用户现在最稳的做法就一句话：先别升级。

等包含修复的正式版本出来，再说。

如果你已经升级了，又刚好很依赖 Dashboard，那就从上面两个方案里选一个补救。

至于那些把版本更新写成封神现场、却连完整升级链路都没亲手跑通的内容，说到底还是老问题：

神是先造出来的，坑是留给人踩的。