734 字
4 分鐘
OpenClaw 2026.3.22 已知問題:Control UI 503,三行指令暫時修復
版本範圍:此問題僅出現在 2026.3.22。若你已升級至更新版本,可以忽略本文。
升級到 2026.3.22 之後,打開 Control UI 只看到一個 503。
先說結論:gateway 沒壞,是官方發布時漏掉了建置 UI 的步驟,agents、Telegram / Discord 連線、cron jobs 全部正常運作,只有瀏覽器介面掛掉。
發生了什麼
啟動 gateway 時出現這段警告:
Control UI assets not found. Build them with `pnpm ui:build`(auto-installs UI deps), or run `pnpm ui:dev` during development.存取 Control UI 收到 HTTP 503,dist/control-ui/ 目錄在安裝包裡根本不存在。
根本原因:npm 發布工作流在打包前沒有完成 UI 建置步驟,dist/control-ui/ 沒有被包進 tarball。這是官方的發布流程疏失,不是你的設定問題。修復 PR #52839 已提交,預計下一個版本修復。
暫時修復方法
從 2026.3.13 版本把 UI 資源提取出來補進去:
tar -xzf openclaw-2026.3.13.tgz package/dist/control-ui/cp -r package/dist/control-ui/ $(npm prefix -g)/lib/node_modules/openclaw/dist/openclaw gateway restart重啟後 Control UI 恢復正常。
注意:這是用 2026.3.13 的 UI 跑 2026.3.22 的 gateway,屬於臨時措施。等官方修正版本釋出後直接升級即可。
2026.3.22 這版還更新了什麼
先交代一下這版的實際變動,因為除了 UI 壞掉之外,這個版本的改動幅度不小。
Breaking Changes
幾個可能讓你升級後發現東西不見的變動:
- 插件安裝改走 ClawHub:
skills install現在優先從 ClawHub 取,不再走 npm - 移除
nano-banana-pro捆綁技能包裝器:有用到的要重新確認安裝方式 - Plugin SDK 路徑改為
openclaw/plugin-sdk/*:自己有寫插件的要更新 import 路徑 - 移除舊版環境變數相容名稱:如果有設定舊版變數名稱,需要對照文件更新
新功能
模型支援擴充
- 新增
anthropic-vertex原生支援 - 新增 OpenAI GPT-5.4 系列
- 同步 MiniMax、xAI、Z.AI 最新模型目錄
- 新增 Chutes 提供商整合
技能與工具
openclaw skills search|install|update完整流程上線- ClawHub 技能發現與安裝整合
- 新增
/btw快捷指令,用於在對話旁邊快速問問題 - Exa、Tavily、Firecrawl 網路搜尋整合
- fal 圖像生成支援
平台與通訊
- 可插拔沙箱後端(OpenShell、SSH)
- 新推出基於官方
matrix-js-sdk的 Matrix 插件 - Feishu 結構化卡片與 ACP 支援
- Telegram 話題自動重新命名
效能與安全
- 移除冷啟動時編譯捆綁 TypeScript(啟動速度改善)
- 延遲載入頻道插件和模型發現
- 強化裝置配對驗證
- 拒絕遠端
file://媒體 URL
等修正版本的時候
如果 Control UI 對你來說不是必要的,其實可以直接維持在壞掉的狀態繼續用——gateway 沒問題,只是看不到介面而已。等官方修正版本出來,直接升級就好,不需要做暫時修復。
如果需要介面,才套用上面的三行指令。
參考來源:
OpenClaw 2026.3.22 已知問題:Control UI 503,三行指令暫時修復
https://laplusda.com/posts/openclaw-v2026-3-22-control-ui-fix/ 這篇文章有幫助嗎?
回報錯字、失效連結,或告訴我你想看的延伸主題。