🧩 OpenClaw 仪表盘突然消失？别慌！手把手教你3分钟找回UI

摘要
最近 OpenClaw 的 v2026.3.22 版本在发布时意外遗漏了 Dashboard 的前端 UI 文件，导致大量用户升级后遇到页面空白的问题。本文提供两种简单可靠的修复方案：一是使用官方自带的 doctor --repair 一键修复；二是手动从旧版本包中复制缺失文件。全程无需删除重装，不丢失配置，小白也能轻松搞定。

---

📌 话题标签

#OpenClaw #Dashboard修复 #UI失踪案 #开发者自救指南

---

🤔 发生了什么？

今天照常启动 openclaw gateway，打开浏览器准备查看 Dashboard，结果：

一片空白！
没有图表，没有设置界面，只有白茫茫的屏幕，仿佛被人“一键清空”了。

执行了 pnpm ui:build，没用；重装？太麻烦，而且配置可能丢失。难道真要删除重下？

别急，这不是你的锅！

---

🔍 问题根源：官方版本“翻车”了

这是 OpenClaw 在 v2026.3.22 版本发布时的一个官方失误——安装包遗漏了 Dashboard 所需的 UI 文件。
也就是说，npm 包里压根就没带 control-ui 这个文件夹，所以你无论怎么 pnpm 构建，都找不到源文件。

官方后来紧急推出了修复工具，我们只需要两步操作就能搞定。

---

✅ 解决方案（二选一）

🛠️ 方案一：官方一键修复（强烈推荐）

这是最简单、最安全的方法，一条命令自动修复所有缺失文件。

# 1. 确保 OpenClaw 是最新版
npm update -g openclaw

# 2. 运行官方修复工具
openclaw doctor --repair

# 3. 重启网关
openclaw gateway restart

刷新浏览器，Dashboard 应该就满血复活了！🎉

---

📦 方案二：手动“搬砖”大法（如果方案一无效）

如果你用的是老版本，或者 doctor 没能修复，也可以手动把 UI 文件从旧版本里“搬”过来。

① 下载包含完整 UI 的旧版本包（v2026.3.13）

cd /tmp
npm pack openclaw@2026.3.13

② 解压出 UI 文件夹

tar -xzf openclaw-2026.3.13.tgz package/dist/control-ui

③ 找到你的全局 OpenClaw 安装目录

which openclaw
# 输出示例：/home/kali/.npm-global/bin/openclaw

ls -l $(which openclaw)
# 输出示例：../lib/node_modules/openclaw/openclaw.mjs

根据软链接推导，安装目录就是 /home/kali/.npm-global/lib/node_modules/openclaw

④ 复制 UI 文件到目标目录

cp -r /tmp/package/dist/control-ui /home/kali/.npm-global/lib/node_modules/openclaw/dist/

⑤ 重启网关

openclaw gateway restart

搞定！刷新页面，熟悉的 Dashboard 又回来啦！

---

💡 一点小建议

• 升级 + doctor 修复 是官方推荐的标准流程，不仅能修复 UI，还能顺便检查其他配置问题，建议作为首选。
• 如果你平时喜欢折腾，或者遇到网络问题，手动复制也完全可靠。
• 以后遇到类似“UI 消失”的问题，可以第一时间想到 doctor --repair，说不定能省下不少时间。

---

🎉 结语

技术路上总有些小插曲，这次 OpenClaw 的“UI 失踪案”虽然让人有点懵，但解决起来其实很简单。希望这篇文章能帮到你，也欢迎在评论区分享你的修复心得！

如果觉得有用，点个赞 👍 或收藏 ⭐ 吧，让更多小伙伴看到！

---