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 資源提取出來補進去:

Terminal window
cd /tmp && npm pack [email protected]
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#

幾個可能讓你升級後發現東西不見的變動:

  • 插件安裝改走 ClawHubskills 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 沒問題,只是看不到介面而已。等官方修正版本出來,直接升級就好,不需要做暫時修復。

如果需要介面,才套用上面的三行指令。

參考來源:

Issue #52957

Issue #52823

Issue #52808

Release v2026.3.22

OpenClaw 2026.3.22 已知問題:Control UI 503,三行指令暫時修復
https://laplusda.com/posts/openclaw-v2026-3-22-control-ui-fix/
作者
Zero
發佈於
2026-03-24
許可協議
CC BY-NC-SA 4.0
這篇文章有幫助嗎?

回報錯字、失效連結,或告訴我你想看的延伸主題。