控制介面

Control UI 是由閘道提供的小型 Vite + Lit 單頁應用程式：

• 預設：http://<host>:18789/
• 選用前綴：設定 gateway.controlUi.basePath（例如 /openclaw）

它會在同一個連接埠上直接連線至閘道 WebSocket。

當你查看執行中的工作階段時，閘道可以使用該代理程式的工具模型，產生精簡的狀態摘要。聊天介面會將其顯示為單行狀態膠囊，展開後則呈現包含評估、計畫進度、PR 與經過時間的卡片。當執行陷入停滯或需要輸入時，卡片可以自動展開一次；/btw 側邊聊天的優先順序高於展開的卡片。

展開的卡片也接受有關該次執行的簡短問題。回答只會使用觀察器目前的摘要與經過清理且有界限的備註，會在該工作階段期間保留於瀏覽器中，且絕不會進入或中斷主要代理程式的執行。如果觀察內容不包含答案，觀察器會表示無法得知。

第一份摘要抵達後，它會取代啟發式即時活動，成為該次執行的側邊欄副標題。最終的完成或失敗摘要會在工作階段仍為未讀時持續顯示，之後該列會恢復為正常的工作副標題。

工作階段觀察預設為啟用。在 Settings > Appearance > Sidebar 中，你可以在整個閘道範圍內將其關閉、檢查解析後的小型模型及其來源，或選擇自動路由、停用工具工作，或選取明確的 agents.defaults.utilityModel。對應的設定控制項為 gateway.controlUi.sessionObserver: false 和 agents.defaults.utilityModel: ""。

快速開啟（本機）

如果閘道正在同一台電腦上執行，請開啟 http://127.0.0.1:18789/（或 http://localhost:18789/）。

如果頁面無法載入，請先啟動閘道：openclaw gateway。

認證會在 WebSocket 交握期間透過下列方式提供：

• connect.params.auth.token
• connect.params.auth.password
• 當 gateway.auth.allowTailscale: true 時使用 Tailscale Serve 身分標頭
• 當 gateway.auth.mode: "trusted-proxy" 時使用受信任 Proxy 身分標頭

閘道認證會在裝置配對之前執行。直接的回送連線不會略過權杖或密碼認證。儀表板設定面板會針對目前的瀏覽器分頁工作階段與所選閘道 URL 保留權杖；密碼不會持久保存。配對後，瀏覽器可以在後續連線中使用已儲存的個別裝置權杖。

初始設定通常會設定閘道權杖以進行共用祕密認證。如果閘道以權杖模式啟動，但未設定權杖，則會改為為該程序產生暫時性的執行階段權杖。執行階段權杖不會寫入設定，因此 openclaw config get gateway.auth.token 無法擷取它，而沒有該權杖的回送瀏覽器會遭到拒絕。請執行 openclaw doctor --generate-gateway-token、重新啟動閘道，然後將設定的權杖貼到 Control UI 設定中。當 gateway.auth.mode 為 "password" 時，也可以改用密碼認證。

裝置配對（首次連線）

閘道認證成功後，從新的瀏覽器或裝置連線通常需要一次性的配對核准，顯示為 disconnected (1008): pairing required。

openclaw devices list

openclaw devices approve <requestId>

如果瀏覽器使用已變更的認證詳細資料（角色／範圍／公開金鑰）重試配對，先前待處理的要求會被取代，並建立新的 requestId；請在核准前重新執行 openclaw devices list。

將已配對的遠端瀏覽器從讀取存取權切換為寫入／管理員存取權時，會視為核准升級，而不是無提示重新連線：OpenClaw 會維持舊核准有效、封鎖權限較廣的重新連線，並要求你明確核准新的範圍集合。符合條件的直接回送 Control UI 連線可在完成認證後自動核准升級。

核准後，系統會記住該裝置，除非你使用 openclaw devices revoke --device <id> --role <role> 撤銷，否則無須再次核准。關於權杖輪替、撤銷，以及 Paperclip / openclaw_gateway 首次執行核准流程，請參閱裝置命令列介面。

配對行動裝置

已配對的管理員無須開啟終端機，即可建立 iOS/Android 連線 QR Code：

建立設定代碼需要 operator.admin；沒有此權限的工作階段會停用該按鈕。設定代碼包含短效啟動認證資訊，因此在 QR Code 與複製的代碼有效期間，請像密碼一樣保護它們。進行遠端配對時，閘道必須解析為 wss://（例如透過 Tailscale Serve/Funnel）；純 ws:// 僅限回送與私人 LAN 位址。完整的安全性與備援詳細資訊，請參閱配對。

個人身分（瀏覽器本機）

Control UI 支援附加至外送訊息的個別瀏覽器個人身分（顯示名稱與頭像），用於共用工作階段中的歸屬標示。它位於瀏覽器儲存空間中，範圍限定於目前的瀏覽器設定檔，不會同步至其他裝置；除了你所傳送訊息上的一般對話記錄作者中繼資料之外，也不會持久保存於伺服器端。清除網站資料或切換瀏覽器會將其重設為空白。

助理頭像覆寫遵循相同的瀏覽器本機模式：上傳的覆寫會在本機覆蓋閘道解析的身分，且絕不會透過 config.patch 往返傳輸。共用的 ui.assistant.avatar 設定欄位仍可供直接寫入該欄位的非 UI 用戶端使用。

執行階段設定端點

Control UI 會從 /control-ui-config.json 擷取執行階段設定，該位置是相對於閘道的 Control UI 基底路徑解析（例如基底路徑 /__openclaw__/ 下的 /__openclaw__/control-ui-config.json）。該端點受與其餘 HTTP 介面相同的閘道認證保護：未經認證的瀏覽器無法擷取，而成功擷取需要有效的閘道權杖／密碼、Tailscale Serve 身分或受信任 Proxy 身分。

閘道主機狀態

開啟 Settings → General，即可查看 Gateway Host 卡片，其中包含閘道機器、LAN 位址、作業系統、執行階段、運作時間、CPU 負載、記憶體，以及狀態磁碟區的磁碟空間。卡片顯示時會每 10 秒透過 system.info 閘道 RPC 重新整理，此 RPC 需要 operator.read 範圍。較舊的閘道以及沒有該範圍的連線會省略此卡片。

語言支援

Control UI 會在首次載入時根據你的瀏覽器語言地區進行本地化。若要稍後覆寫，請開啟 Settings -> General -> Language（選擇器位於 General 頁面，而非 Appearance 下方）。

• 支援的語言地區：en、ar、de、es、fa、fr、hi、id、it、ja-JP、ko、nl、pl、pt-BR、ru、th、tr、uk、vi、zh-CN、zh-TW
• 非英文翻譯會在瀏覽器中延遲載入。
• 所選語言地區會儲存在瀏覽器儲存空間中，並於日後造訪時重複使用。
• 缺少的翻譯鍵會回退至英文。

文件翻譯會針對相同的非英文語言地區集合產生，但文件網站內建的 Mintlify 語言選擇器只會列出 Mintlify 接受的語言地區代碼。泰文（th）和波斯文（fa）文件仍會在發布儲存庫中產生；在 Mintlify 支援這些代碼之前，它們可能不會出現在該選擇器中。

外觀佈景主題

Appearance 面板內建 Claw、Knot 和 Dash 佈景主題（預設為 Claw），另有一個僅限瀏覽器本機的 tweakcn 匯入插槽。若要匯入佈景主題，請開啟 tweakcn 編輯器，選擇或建立佈景主題，按一下 Share，再將複製的連結貼到 Appearance。匯入工具也接受 https://tweakcn.com/r/themes/<id> 登錄 URL、如 https://tweakcn.com/editor/theme?theme=amethyst-haze 的編輯器 URL、相對 /themes/<id> 路徑、原始佈景主題 ID，以及如 amethyst-haze 的預設佈景主題名稱。

匯入的佈景主題只會儲存在目前的瀏覽器設定檔中；不會寫入閘道設定，也不會跨裝置同步。替換匯入的佈景主題會更新該本機插槽；如果當時使用的是匯入的佈景主題，清除後會切換回 Claw。

Appearance 也有 Text size 設定。它會套用至聊天文字、撰寫器文字、工具卡片與聊天側邊欄，並確保文字輸入至少為 16px，避免行動版 Safari 在聚焦時自動縮放。

主題、主題模式、文字大小、語言和聊天顯示偏好會透過閘道設定 (ui.prefs) 同步，因此這些設定會隨你跨裝置套用，代理程式也能透過核准閘門變更它們——已連線的用戶端會經由閘道的 config.changed 通知即時套用變更。每個瀏覽器都會保留本機鏡像，以便立即啟動；無法寫入設定的用戶端（檢視者範圍、離線）則僅在該裝置上保留變更。請參閱設定參考。

OpenClaw 系統維護

開啟 Settings → Ask OpenClaw，與系統設定及修復代理程式交談。在新手引導之外，此頁面每次造訪最多顯示一個可關閉的事件標籤。對於例行的閘道流量，它會保持靜默，僅在健康情況快照回報設定重新載入器已停用、已設定的頻道中斷連線或效能降低、頻道探測失敗，或頻道認證資訊無法使用時作出反應。只有嚴重程度更高的新事件才會取代待處理的標籤；關閉或使用標籤後，本次造訪期間將不再顯示事件提示。按一下標籤會將其診斷問題以真正的 openclaw.chat 訊息傳送，因此逐字記錄會保留該要求，並由 OpenClaw 執行診斷。新手引導期間絕不會顯示這些事件標籤。

管理外掛

開啟側邊欄中的 外掛，或使用相對於已設定 Control UI 基底路徑的 /settings/plugins，即可在不離開 Control UI 的情況下瀏覽及管理外掛。 例如，基底路徑為 /openclaw 時，會使用 /openclaw/settings/plugins。即使所有選用外掛都已停用，此頁面仍一律可用。

外掛是一個包含四個分頁的中心：已安裝和探索用於管理 /settings/plugins 中的外掛程式碼，Skills 在 /skills 提供各代理程式的技能管理器，而工作坊則在 /skills/workshop 提供 Skill Workshop 提案審查。每個分頁都會保留自己的 URL，而側邊欄則以單一的外掛項目代表所有分頁。

已安裝分頁會依類別分組顯示完整的本機清單，並提供總覽計數。 每一列都可開啟詳細資料檢視；其溢位 (…) 選單可啟用 或停用外掛，並為外部安裝的外掛提供移除選項。 其中也會列出已設定的 MCP 伺服器，並支援直接新增、停用及 移除。相同的伺服器控制項也位於 Settings → MCP。 探索分頁就是商店：其中包含隨 OpenClaw 提供的精選外掛、 官方外部外掛，以及熱門服務的一鍵式 MCP 連接器。 在搜尋框中輸入內容會直接查詢 ClawHub，並附加來自 ClawHub 區段，其中包含下載次數和來源驗證徽章。深層連結可透過 /settings/plugins?tab=discover 直接指向商店。

Skills 分頁會保留技能狀態報告、啟用／停用切換開關、API 金鑰輸入，以及內嵌的 ClawHub 技能搜尋，範圍限定於所選代理程式。 工作坊分頁會保留 Skill Workshop 看板和今日的 技能提案審查流程。尋找技能構想會從最新到最舊， 審查一段有限範圍內的重要工作階段，並將任何結果保留為待處理提案。 面板會顯示累計涵蓋範圍；掃描較早的工作會從已保存的游標繼續， 在較舊的歷史記錄耗盡後則變為掃描新工作。即使自主自我學習已停用， 仍可手動審查歷史記錄，並會使用所選代理程式已設定的模型。

隨附的外掛已存在於閘道上，並會顯示啟用或停用，而非安裝。 例如，Workboard 隨 OpenClaw 提供但預設為停用，因此其動作為啟用。 隨附的外掛無法移除，只能停用。

讀取目錄及搜尋 ClawHub 需要 operator.read。安裝、 啟用、停用或移除外掛，以及變更 MCP 伺服器，則需要 operator.admin；唯讀操作員無法使用這些動作。

ClawHub 安裝會透過閘道執行，並採用與其他閘道媒介安裝相同的信任、完整性 及外掛安裝原則檢查。安裝或移除外掛程式碼需要重新啟動閘道。若外掛和目前的 閘道執行階段支援，啟用或停用已安裝的外掛可在不重新啟動的情況下套用； 否則 UI 會回報需要重新啟動。新增由 OAuth 支援的 MCP 連接器後， 需要從命令列介面執行一次 openclaw mcp login <name>。

此頁面刻意聚焦於清單、探索、安裝、啟用和移除。若要使用任意 npm、git 或本機路徑來源、進行更新及進階外掛設定，請使用 openclaw plugins。

應用程式與擴充功能

從側邊欄的 More 選單、命令選擇區或側邊欄代理程式選單 (Get the apps) 開啟應用程式，或使用相對於已設定 Control UI 基底路徑的 /apps。此頁面彙整每個 OpenClaw 伴隨介面的安裝連結： iOS 和 Android 應用程式、 與其一同隨附的 Apple Watch 和 Wear OS 伴隨程式、 macOS、Windows 和 Linux 桌面應用程式、 Chrome 擴充功能、包含 ClawHub 的應用程式內外掛中心，以及 Discord 社群和文件。

側邊欄導覽

側邊欄以代理程式為中心組織所有內容。頂端的身分列是作用中的代理程式；其下方的頁面區段以首頁開始——這是代理程式持續更新的主要工作階段，並以徽章顯示其未讀或執行中狀態——後面接著釘選的目的地（預設為自動化和外掛）。頁面標題上的自訂控制項會開啟包含其他所有目的地的選單，其中包括使用量、外掛提供的分頁，以及編輯釘選項目；在導覽區域按一下滑鼠右鍵可直接開啟釘選編輯器。下方的工作階段清單分為數個區域：討論串用於代理程式的聊天工作階段（主要工作階段保留在首頁後方；由它產生的工作階段會在此顯示為頂層討論串，而具名討論串不會顯示類型前綴）、群組用於群組和聊天室對話，以及程式設計用於繫結至受管理工作樹或執行節點的工作階段（各列會顯示 repo ⎇ branch 行及節點主機）、由 ACP 支援的測試工具工作階段，以及 Codex／Claude 命令列介面目錄。程式設計區域在首次執行時預設收合，並會記住你的選擇；收合後的標題仍會保留實際計數，且所含工作階段執行時會顯示執行中指示器。自訂群組（工作階段的 category）和已釘選列位於討論串上方，而將工作階段指派至自訂群組，一律優先於自動區域分類。討論串標題包含排序控制項（建立時間或上次更新時間、分組依據，以及可保存的狀態篩選器，可選作用中、已封存或全部）和用來開啟新工作階段頁面的 +。已封存的列仍會以暗色顯示在原處，並帶有封存圖示；它們不會計入未讀或需要注意的狀態，也不會參與譜系提升。開啟工作階段只會移動選取醒目提示，不會重新排列各列。近期有子項執行的父工作階段會顯示展開控制項和子項計數；展開後即可在不離開側邊欄的情況下，檢查巢狀子工作階段、即時或終止狀態，以及執行階段。選取子項會開啟其聊天，並自動顯示其祖先路徑。子項列不會參與根層級分組、釘選、拖曳、多重選取及分頁；收合的區域不會占用可見頁面額度。自上次讀取後有新活動的工作階段會顯示未讀圓點，開啟後即標示為已讀。代理程式也能發布一行短暫有效的狀態，並可選擇以精選的琥珀色圖示要求注意；當你開啟工作階段、傳送下一則訊息、明確清除狀態，或其 TTL 到期時，此宣告便會清除。雲端工作者的生命週期狀態使用地球徽章；本機和已收回的工作階段不顯示位置徽章，因為本機執行是預設值。每個根工作階段列都有快顯選單（三點按鈕或按一下滑鼠右鍵），其中包含釘選／取消釘選、標示為未讀／已讀、重新命名、分支、移至群組（包括新增群組和從群組移除）、封存或取消封存，以及刪除；觸控版面會讓直接釘選和選單控制項保持可見。按住 Cmd／Ctrl 並按一下可切換根列的多重選取狀態，按住 Shift 並按一下則會依可見順序延伸選取範圍；接著在所選列上開啟選單時，會提供批次動作（將 N 個標示為未讀／已讀、將 N 個移至群組、封存 N 個、刪除 N 個），並套用至所有選取的工作階段，而批次刪除只需確認一次。將根工作階段拖曳至已釘選即可釘選，或拖曳至自訂群組即可移動。自訂群組標題可以收合、展開或拖曳以重新排序；群組名稱及其順序儲存在閘道 (sessions.groups.*) 中，因此會隨你跨瀏覽器套用，而收合狀態則保留在瀏覽器設定檔中。群組標題也有選單（三點按鈕或按一下滑鼠右鍵），其中包含重新命名群組、新增群組和刪除群組；重新命名或刪除群組時，會在伺服器端更新每個成員工作階段，包括已封存的工作階段，而刪除群組會保留其中的工作階段，並將其移回討論串。

新工作階段頁面

側邊欄工作階段清單標題中的 + 會在 /new 開啟整頁草稿：在你傳送第一則訊息前，不會建立任何項目。統一的位置選擇器可選擇工作資料夾，且管理員操作員還能選擇執行目的地：閘道 · 本機、公開 system.run 的已配對節點，或可用的雲端設定檔。資料夾預設為代理程式工作區；其他絕對閘道路徑需要 operator.admin，但即使不是 Git 簽出，也能直接執行。若所選閘道資料夾是 Git 簽出，同一選擇器會提供選用的工作樹隔離功能，並搭配由 worktrees.branches 支援的基底分支選擇器（不執行擷取）及選用的工作樹名稱（分支會變為 openclaw/<name>）。雲端工作者必須使用該受管理的工作樹路徑；已配對節點絕不會公開此選項。編輯器頁尾可選擇新工作階段的模型和推理層級。其無痕切換開關會建立僅限網頁的討論串，其工作階段項目、逐字記錄和壓縮狀態都會保留在記憶體中，直到閘道重新啟動；OpenClaw 也會略過其自動記憶清理。代理程式仍保有一般工具，因此明確的儲存要求或工具驅動的檔案寫入仍可將資料保存下來。模型提供者仍會處理訊息，且不含內容的稽核中繼資料仍會被記錄。雲端啟動會先保存模型和推理選擇，再將工作階段分派給其工作者。

在多使用者閘道上，只有具管理員範圍的連線可以建立或檢視無痕討論串，其他工作階段也無法透過代理程式工作階段工具或逐字記錄搜尋存取它們。無痕模式可防止資料被儲存或被其他透過閘道操作的使用者存取，但無法防範閘道擁有者或程序操作員，因為他們始終可以觀察即時工作階段。

瀏覽資料夾會開啟位置選擇器的內嵌目錄瀏覽器，此功能由僅限管理員的 fs.listDir 方法支援，且範圍限定於所選閘道或節點。閘道和具備瀏覽功能的節點會列出其檔案系統；具備執行功能但沒有 fs.listDir 的節點，仍可接受手動輸入的絕對路徑。最近使用的位置可以一併還原資料夾及其所屬節點，而不會跨主機沿用路徑。提交時會使用第一則訊息呼叫 sessions.create，因此執行會在同一次往返中開始，UI 也會跳至新工作階段的聊天。若閘道已建立工作階段，但拒絕第一次傳送，聊天會在重新載入後保留提示和錯誤；重試會透過已建立的工作階段傳送，而不會再建立另一個工作階段。

在 Settings 中，專用側邊欄包含 Ask OpenClaw，並以搜尋設定欄位開頭，方便快速尋找設定區段。

在桌面版網頁中，內容區域左上角有一組固定控制項，對應 macOS 的標題列控制帶，其中包含收合側邊欄切換按鈕（⌘B）和命令選擇區搜尋按鈕（⌘K）。按一下側邊欄頂端的代理程式身分列，即可開啟代理程式選單；首頁會開啟主要工作階段。當有項目需要處理時（例如失敗或逾期的排程工作、即將到期或已到期的模型驗證），側邊欄頁尾上方會顯示精簡的注意事項籤，按一下即可前往負責該項目的頁面。身分列會顯示代理程式的頭像（身分圖片或表情符號）、名稱、連線狀態圓點，以及即時副標題。其代理程式範圍選單包含內嵌代理程式切換器（多代理程式設定）、新增代理程式、“這個代理程式能做什麼？”和代理程式設定。代理程式清單超過十個時，會顯示篩選欄位，並優先列出已釘選的代理程式；你可以在代理程式設定頁面釘選或取消釘選代理程式，釘選集合會儲存在瀏覽器設定檔中。選擇代理程式後，聊天、用量、自動化、任務、工作看板和工作階段都會限定於該代理程式。每個限定範圍的頁面都會提供代理程式控制項，並可選擇所有代理程式來退出限定範圍；這會擴大共用頁面的範圍，而不會變更實際聊天使用的代理程式，直接工作階段連結仍會開啟其目標。代理程式設定頁面會保留自己的 ?agent= 選取項目，不會跟隨共用頁面範圍。頁尾是一張全寬身分卡，即使離線也仍可使用，並會在最後已知的帳戶名稱下方顯示正在重新連線…。它會開啟應用程式／帳戶選單，其中的設定檔身分標頭後依序提供設定、用量、行動裝置配對、取得應用程式、說明（說明、Discord、文件和變更記錄）、需要時顯示的離線重試動作、版本／組建標籤，以及色彩模式切換按鈕。組建標籤會開啟「關於」頁面。當閘道從來源簽出執行，且所在分支不是 main 時，頁尾也會以紅色顯示該分支名稱，讓人一眼就能辨識這是非發行版閘道（發行版安裝永遠不會顯示此資訊）。在 Apple 平台上按 Shift-Command-Comma，或在其他平台上按 Ctrl-Shift-Comma，即可開啟設定，且不會覆寫瀏覽器原有的 Command-Comma 快速鍵。收合側邊欄（按 ⌘B 或控制項組中的切換按鈕）會將其完全隱藏，以提供全寬工作區；收合時，左上角控制項組會保留展開切換按鈕和搜尋功能，並新增討論串按鈕，對應 macOS 應用程式原生置於標題列中的功能。側邊欄是桌面版唯一的導覽介面，不另設頂端列。較窄的檢視區會以滑出式抽屜取代側邊欄，並在精簡標頭列中放置抽屜切換按鈕、品牌標誌和命令選擇區搜尋；在手機上，聊天會將該導覽列整合到標題列中，並在工作階段標題旁顯示選單和搜尋控制項。在 macOS 應用程式中，獨立的標頭列會將標題列的預留空間整合成視窗控制項旁的一條精簡控制帶。導覽會使用一般瀏覽器記錄，因此可透過瀏覽器的上一頁／下一頁按鈕瀏覽；macOS 應用程式還會在視窗控制項旁新增原生側邊欄切換按鈕和觸控式軌跡板滑動手勢，側邊欄展開時會在其右側邊緣顯示上一頁／下一頁按鈕，收合時則顯示原生搜尋（命令選擇區）和新增工作階段按鈕。

待核准項目也會在側邊欄頁尾上方顯示注意事項籤； 選取該標籤即可開啟負責該項目的核准頁面。

目前可執行的功能

匯入助理記憶

開啟 設定 → 匯入記憶，將本機 Codex 或 Claude Code 記憶 匯入 OpenClaw 代理程式。閘道會自行探索其所在 主機上支援的本機記憶，因此遠端控制介面會從閘道電腦匯入，而非從 瀏覽器電腦匯入。

1. 選擇目的代理程式。
2. 檢閱偵測到的來源集合與 Markdown 檔名。檔案內容 不會在規劃回應中傳送，也不會顯示於頁面中。
3. 選取要匯入的集合並確認。套用會在 寫入前重新建立規劃，讓過期的選取項目安全地失敗。
4. 若檔案已存在，請啟用 取代現有匯入項目、重新整理 預覽，然後確認取代。

Codex 僅匯入其整合後的 MEMORY.md 和 memory_summary.md。Claude Code 會從專案自動記憶目錄和已設定的 autoMemoryDirectory 匯入 Markdown；它不會透過此頁面匯入工作階段、設定、指示或 認證資訊。檔案會複製到所選工作區中的 memory/imports/ 之下，作用中的記憶外掛可在該處為其建立索引。來源 絕不會被變更。

規劃與套用需要 operator.admin。每次套用都會在有狀態資料時建立經驗證的 OpenClaw 備份、寫入已遮蔽的遷移報告，並在取代現有目的檔案前保留 項目層級的備份。如需路徑和 回想行為，請參閱記憶概觀。

MCP 頁面

專用 MCP 頁面是供操作者檢視 OpenClaw 所管理之 MCP 伺服器的介面，這些伺服器位於 mcp.servers 之下。它本身不會啟動 MCP 傳輸；請使用此頁面檢查及編輯已儲存的設定，並在需要即時伺服器驗證時使用 openclaw mcp doctor --probe。

一般工作流程：

1. 從側邊欄開啟 MCP。
2. 查看摘要卡片中的伺服器總數、已啟用、OAuth 與已篩選數量。
3. 檢查每個伺服器列的傳輸方式、啟用狀態、驗證、篩選器、逾時與命令提示。
4. 直接在 MCP 頁面新增、啟用、停用或移除伺服器。明確選擇 Streamable HTTP、SSE 或 stdio；stdio 命令列接受引號括住的引數，例如包含空格的路徑。使用 Plugins 頁面進行一鍵連接與探索。
5. 編輯限定範圍的 mcp 設定區段，以設定環境變數、工作目錄、標頭、TLS/mTLS 路徑、OAuth 中繼資料、工具篩選器與 Codex 投影中繼資料等進階伺服器欄位。
6. 使用 Save 寫入設定；若要讓執行中的閘道套用變更後的設定，則使用 Save & Publish。
7. 從終端機執行 openclaw mcp status --verbose、openclaw mcp doctor --probe 或 openclaw mcp reload，以進行靜態診斷、即時驗證或清除快取的執行階段。

此頁面會在算繪前遮蔽含認證資訊且類似 URL 的值，並在命令片段中以引號括住伺服器名稱，讓複製的命令即使包含空格或 shell 中繼字元仍可正常運作。完整的命令列介面與設定參考：MCP。

活動分頁

活動分頁位於 Settings › System，在 Logs 和 Debug 旁邊。它是暫時性的瀏覽器本機即時工具活動觀察器，資料來自支援聊天工具卡片的同一個閘道 session.tool／工具事件串流。它不會新增其他閘道事件系列、端點、持久活動儲存區、指標動態消息或外部觀察器串流。

活動項目只會保留經過清理的摘要，以及經遮蔽與截斷的輸出預覽。工具引數值不會儲存在活動狀態中；使用者介面會顯示引數已隱藏，且只記錄引數欄位數量。記憶體內的清單跟隨目前的瀏覽器分頁，在控制介面內導覽時會保留，並在重新載入頁面、切換工作階段或按下 Clear 時重設。

操作員終端機

可停駐的操作員終端機預設為停用。若要啟用，請設定 gateway.terminal.enabled: true 並重新啟動閘道。終端機需要 operator.admin 連線，並在目前作用中代理程式的工作區內開啟主機 PTY。新分頁會跟隨目前選取的聊天代理程式。

使用 Ctrl + backtick 切換停駐面板。版面配置支援停駐於底部或右側、隨瀏覽器檢視區調整大小，並保留多個 shell 分頁。關於 gateway.terminal.enabled 與選用的 gateway.terminal.shell 覆寫值，請參閱閘道設定。

經擁有者授權且未受沙箱限制的代理程式，可使用 terminal 工具處理需要操作員監看的長時間或互動式工作。每次工具呼叫都可以開啟、讀取、寫入、調整大小、關閉代理程式自己的閘道 PTY，或列出這些 PTY。新工作階段預設會開啟共同連接的控制介面分頁，讓代理程式與操作員共用輸出，且雙方皆可輸入或調整大小。代理程式存取權限精確限定於工作階段：代理程式無法讀取或控制操作員建立的終端機，或由其他代理程式工作階段開啟的終端機。

將一或多個檔案拖曳到作用中的終端機，或使用迴紋針按鈕選擇檔案。OpenClaw 會在擁有該 PTY 的機器上暫存每個檔案，並在游標位置貼上經 shell 引號處理的絕對路徑；它絕不會按下 Enter 或執行輸入。精簡的批次指示器會顯示目前檔案與已完成數量。取消會停止剩餘批次而不貼上路徑；傳輸失敗的檔案會保持顯示，讓你可從該檔案重試，而無須重新上傳已完成的檔案。接受圖片、PDF、封存檔與其他檔案類型，每個檔案上限為 16 MiB。暫存檔案在 POSIX 主機上會使用私有的系統暫存目錄（目錄模式 0700、檔案模式 0600），在 Windows 上則使用位於使用者設定檔 ACL 邊界內的目錄，並設有 24 小時清理計時器，因此請移動或複製任何需要保留的檔案。

路徑插入支援 PowerShell、cmd.exe 與可辨識的 POSIX shell（sh、Bash、Dash、Ash、Ksh、Zsh 和 Fish），包括 Windows 上的 Git Bash。系統會拒絕其他 shell 覆寫，因為無法安全推斷其引號規則；若要使用原生 WSL 終端機與 Linux 上傳路徑，請在 WSL 內執行閘道。系統也會拒絕包含 % 或 ! 的 cmd.exe 路徑，因為該 shell 即使在雙引號內仍會展開這些字元。

在工作階段側邊欄中找到的 Codex 與 Claude Code 工作階段，可以在同一個終端機面板內以其原生命令列介面開啟。在 Settings › Chat 中，將 Open Codex/Claude threads in 設為 Terminal，即可讓一般的列點擊開啟 codex resume 或 claude --resume；預設仍為唯讀的 OpenClaw 檢視器。對列按一下滑鼠右鍵或開啟其三點選單時，永遠都會提供這兩個選項；符合資格的工作階段，其檢視器標頭也會包含 Open in terminal。

資格會依工作階段和主機分別判定。閘道本機工作階段會在閘道主機上啟動由提供者擁有的繼續執行命令。配對節點工作階段會在所屬節點上啟動允許清單中的提供者命令，且只轉送該 PTY 的輸出、輸入與調整大小事件；這不會公開一般節點 shell，也不接受瀏覽器提供的命令。檔案上傳使用獨立且有大小限制的 terminal.upload 節點命令，並持續繫結至已開啟的終端機工作階段。該命令首次出現時，請核准節點配對升級。未公告相符終端機繼續執行命令的節點（包括不具雙向串流的內嵌工作程式橋接器）仍可使用檢視器，但會顯示無法開啟終端機；舊版節點仍可執行終端機，但無法接收拖曳的檔案。

連線所擁有的工作階段會在中斷連線後繼續存活：頁面重新載入、筆電休眠或網路短暫中斷時，工作階段會在閘道上中斷連接而非終止；重新連線後，同一個瀏覽器分頁會重新連接，並重播近期輸出。已中斷連接且由連線擁有的工作階段會在 gateway.terminal.detachedSessionTimeoutSeconds 後終止（預設為 300 秒；0 會恢復中斷連線即終止）。連接至其中一個工作階段時，仍會採用類似 tmux 的接管方式。

代理程式所擁有的工作階段不會繫結至瀏覽器連線。terminal.attach 會將每個瀏覽器新增為檢視者而不取得擁有權，關閉檢視器分頁只會中斷該瀏覽器的連接。PTY 會一直保留，直到擁有它的代理程式將其關閉、其處理程序結束、政策將其停用，或閘道關閉為止。terminal.list 會將每個項目標示為由連線或代理程式擁有，terminal.text 則可讓管理員連線在不連接的情況下讀取近期純文字輸出。

終端機也提供位於 /?view=terminal 的全螢幕純終端機文件。iOS 與 Android 應用程式會在其終端機畫面中嵌入此頁面，重複使用已儲存的閘道認證資訊；可用性遵循相同的 gateway.terminal.enabled 與 operator.admin 閘門，且當連線的閘道未提供終端機時，頁面會顯示通知。

瀏覽器面板

控制介面隨附可停駐的瀏覽器面板，可在任何一般網頁瀏覽器中呈現由閘道控制的瀏覽器（也就是代理程式透過瀏覽器工具操作的同一個瀏覽器），無須原生 WebView。當連線的閘道向 operator.admin 連線公告 browser.request 時，此面板便會出現；討論串工作區軌道中的地球按鈕可切換面板。面板會顯示即時頁面快照，並提供分頁、可編輯的 URL 列、上一頁／下一頁／重新載入和在你的瀏覽器中開啟等功能；可停駐於右側或底部，並將點擊、滾輪捲動與基本輸入轉送至遠端頁面。

兩種擷取模式可為代理程式封裝頁面情境：

• 註記（鉛筆）：在頁面上繪製徒手標記。傳送至聊天會將筆畫合成到螢幕截圖中、把圖片附加至作用中的聊天編輯器，並預先填入描述頁面 URL、標題與每個標記區域的提示，讓代理程式確切知道你圈選的位置。
• 檢查（指標）：將游標停留在元素上，以查看游標下方的元素（選取器、無障礙名稱、角色、大小）；按一下即可透過相同的編輯器流程傳送該元素的詳細資料與醒目標示的螢幕截圖。檢查、滾輪捲動與上一頁／下一頁需要 browser.evaluateEnabled（預設開啟）。

macOS 應用程式會為在儀表板中點擊的連結保留其原生連結瀏覽器側邊欄；瀏覽器面板在其中也可運作，且是在所有其他平台上註記頁面的方式。

聊天行為

連線中斷與重新連線

工作階段建立後，閘道連線中斷不會將你登出。儀表板 仍會顯示，頂端列下方會浮現琥珀色的「閘道連線已中斷 — 正在重新連線…」膠囊提示， 同時用戶端會以退避機制自動重試（從 800 毫秒至最長 15 秒）。即時更新與 即時／工作階段動作會暫停，直到連線恢復；膠囊提示中的 Retry now 會強制 立即嘗試。聊天內容仍可編輯：一般文字與附件傳送會保存在 目前分頁依閘道／工作階段限定範圍的瀏覽器儲存空間中，顯示為等待重新連線，並在 閘道恢復後自動傳送。離線期間，即時控制項與斜線命令仍無法使用， 但 Stop 可將確切本機執行 ID 排入佇列以供重播。僅針對工作階段的停止 不會重播，因為連線恢復前，該工作階段中可能已開始較新的工作。

當此瀏覽器已有認證資訊（已設定的權杖／密碼或已核准的裝置 權杖）時，首次開啟與重新載入會在連線建立期間顯示小型動畫 OpenClaw 標誌， 而不會短暫顯示登入閘門。只有尚未儲存認證資訊，或閘道主動拒絕認證資訊 （錯誤的權杖／密碼、已撤銷的配對）時，才會顯示登入閘門—— 這些狀態需要你提供輸入，而不是等待。

安裝 PWA 與 Web Push

控制介面隨附 manifest.webmanifest 與服務工作站，因此現代瀏覽器可將其安裝為獨立 PWA。Web Push 可讓閘道以通知喚醒已安裝的 PWA，即使分頁或瀏覽器視窗未開啟亦然。

在 macOS 應用程式內，「通知」設定頁面會顯示應用程式的原生通知權限，而非瀏覽器推播，因為應用程式會以原生方式傳送通知。

如果頁面在 OpenClaw 更新後立即顯示 Protocol mismatch，請先使用 openclaw dashboard 重新開啟儀表板並執行強制重新整理。如果仍然失敗，請清除儀表板來源的網站資料，或在私密瀏覽器視窗中測試；舊分頁或瀏覽器服務工作站快取可能會繼續執行更新前的控制介面套件，並連線至較新的閘道。

從已淘汰的 push/vapid-keys.json 與 push/web-push-subscriptions.json 儲存區升級時，其資料會由 openclaw doctor --fix 匯入。執行該修復前請停止閘道，以免舊程序在匯入期間重新建立已淘汰的狀態。升級後使用 Web Push 前請先執行修復；只要任一已淘汰的來源或中斷的 Doctor 宣告仍然存在，註冊、傳遞、刪除與金鑰解析都會拒絕繼續執行。閘道執行階段僅讀寫 SQLite。

若要固定金鑰（多主機部署、密鑰輪替或測試），可透過閘道程序的環境變數覆寫 VAPID 金鑰組：

• OPENCLAW_VAPID_PUBLIC_KEY
• OPENCLAW_VAPID_PRIVATE_KEY
• OPENCLAW_VAPID_SUBJECT（預設為 https://openclaw.ai）

控制介面使用以下具範圍閘門的閘道方法，註冊及測試瀏覽器訂閱：

• push.web.vapidPublicKey 會擷取使用中的 VAPID 公開金鑰。
• push.web.subscribe 會註冊 endpoint 以及 keys.p256dh/keys.auth。
• push.web.unsubscribe 會移除已註冊的端點。
• push.web.test 會將測試通知傳送至呼叫端的訂閱。

託管嵌入內容

助理訊息可使用 [embed ...] 短代碼，在行內呈現託管的網頁內容。iframe 沙箱原則由 gateway.controlUi.embedSandbox 控制：

核心 show_widget 工具可直接從工具呼叫呈現獨立完備的 SVG 或 HTML。瀏覽器與支援的原生聊天用戶端會公布 inline-widgets 閘道功能，聊天歷程重新載入後，產生的 Canvas 文件仍可使用。Discord Activities 會在 Discord 上提供相同的工具名稱；來自其他頻道的執行不會收到此工具。

{  gateway: {    controlUi: {      embedSandbox: "scripts",    },  },}

預設仍會封鎖絕對外部 http(s) 嵌入網址。若要允許 [embed url="https://..."] 載入第三方頁面，請設定 gateway.controlUi.allowExternalEmbedUrls: true。

聊天文字記錄版面配置

聊天記錄使用與輸入框對齊、置中且易於閱讀的框架。助理與工具輸出在該框架內維持靠左對齊，而你自己的訊息維持靠右對齊。在多使用者工作階段中（例如從頻道外掛轉送的群組聊天），其他具署名參與者的訊息會靠左顯示，並附上作者的頭像、名稱，以及每個身分固定使用的顏色，因此只有已登入檢視者的訊息會被視為「我的」。當有兩位以上具署名的參與者時，助理回覆會帶有一個小型的「正在回覆名稱」標記，指出是哪位參與者的訊息觸發了該輪對話。本機斜線命令輸出等系統項目會顯示為不含頭像的置中通知列。

聊天訊息寬度

寬螢幕使用者可在 設定 → 聊天 → 訊息寬度 下覆寫聊天記錄寬度。此偏好設定會保留在該瀏覽器的本機儲存空間中。支援的 格式包括一般長度與百分比，例如 960px 或 82%，以及 受限的 min(...)、max(...)、clamp(...)、calc(...) 和 fit-content(...) 寬度運算式。

Tailnet 存取（建議）

openclaw gateway --tailscale serve

openclaw gateway --bind tailnet --token "$(openssl rand -hex 32)"

不安全的 HTTP

如果你透過一般 HTTP（http://<lan-ip> 或 http://<tailscale-ip>）開啟儀表板，瀏覽器會在非安全內容環境中執行並封鎖 WebCrypto。根據預設，OpenClaw 會封鎖沒有裝置身分的控制介面連線。

支援的無裝置身分例外，是透過 gateway.auth.mode: "trusted-proxy" 成功完成操作員控制介面驗證。不存在可停用裝置身分的 永久設定開關。

**建議的修正方式：**使用 HTTPS（Tailscale Serve），或在本機的 https://<magicdns>/（Serve）或 http://127.0.0.1:18789/（位於閘道主機上）開啟介面。

如需 HTTPS 設定指引，請參閱 Tailscale。

內容安全政策

控制介面隨附嚴格的 img-src 政策：僅允許同源資產、data: URL，以及本機產生的 blob: URL。遠端 http(s) 與通訊協定相對圖片 URL 會遭瀏覽器拒絕，且絕不會發出網路擷取請求。

實際上：

• 透過相對路徑提供的頭像與圖片（例如 /avatars/<id>）仍會正常呈現，包括介面擷取並轉換成本機 blob: URL 的已驗證頭像路由。
• 行內 data:image/... URL 仍會正常呈現。
• 由控制介面建立的本機 blob: URL 仍會正常呈現。
• GitHub 連結預覽頭像由閘道從 GitHub 固定的頭像主機擷取，並以有界限的 data: URL 傳回；操作員瀏覽器絕不會連絡遠端頭像主機。
• 頻道中繼資料所輸出的遠端頭像 URL，會在控制介面的頭像輔助函式中被移除並替換為內建標誌/徽章，因此遭入侵或惡意的頻道無法迫使操作員瀏覽器任意擷取遠端圖片。

此功能永遠啟用，且無法設定。

頭像路由驗證

設定閘道驗證後，控制介面的頭像端點會要求使用與其餘 API 相同的閘道權杖：

• GET /avatar/<agentId> 僅向已驗證的呼叫端傳回頭像圖片。GET /avatar/<agentId>?meta=1 依相同規則傳回頭像中繼資料。
• 對任一路由提出的未驗證請求都會遭拒絕（與同層的助理媒體路由一致），因此頭像路由不會在其他部分均受保護的主機上洩漏代理程式身分。
• 控制介面在擷取頭像時會將閘道權杖作為持有人標頭轉送，並使用已驗證的 blob URL，讓圖片仍能在儀表板中呈現。

如果你停用閘道驗證（不建議在共用主機上這麼做），頭像路由也會與閘道的其他部分一致，變成不需要驗證。

助理媒體路由驗證

設定閘道驗證後，助理本機媒體預覽會使用兩階段路由：

• GET /__openclaw__/assistant-media?meta=1&source=<path> 需要一般的控制介面操作員驗證；瀏覽器在檢查可用性時，會將閘道權杖作為持有人標頭傳送。
• 成功的中繼資料回應會包含短期有效的 mediaTicket，其範圍限定於該確切來源路徑。
• 由瀏覽器呈現的圖片、音訊、影片與文件 URL 會使用 mediaTicket=<ticket>，而不是有效中的閘道權杖或密碼。該票證會很快到期，且無法授權其他來源。

這能在不將可重複使用的閘道認證資訊放入可見媒體 URL 的情況下，讓媒體呈現與瀏覽器原生媒體元素相容。

核准連結

操作員核准通知可以深層連結至保留的 ${controlUiBasePath}/approve/{approvalId} 命名空間下所提供的獨立核准文件（例如 /approve/<approvalId>，或在設定基礎路徑時使用 /openclaw/approve/<approvalId>）。該 URL 在核准的生命週期內保持穩定，可安全轉寄至你自己的裝置：它只會識別核准，絕不會授權核准。

• 單區段的 /approve/<approvalId> 命名空間由閘道保留，其優先順序高於外掛 HTTP 路由，並適用於所有 HTTP 方法，因此外掛路由絕不可能遮蔽或攔截核准文件。
• 開啟核准文件時，需要使用與控制介面其餘部分相同的閘道驗證（權杖/密碼、Tailscale Serve 身分或受信任代理伺服器身分）；認證資訊絕不會成為核准 URL 的一部分。
• 停用控制介面服務時，對該命名空間提出的請求會傳回 404，而不會繼續交由外掛處理常式處理。
• 在核准文件上登入僅對該頁面暫時有效：它不會覆寫同一瀏覽器中由完整控制介面儲存的閘道選擇或設定。

閘道從 dist/control-ui 提供靜態檔案：

pnpm ui:build

選用的絕對基底（固定資產 URL）：

OPENCLAW_CONTROL_UI_BASE_PATH=/openclaw/ pnpm ui:build

本機開發（獨立開發伺服器）：

pnpm ui:dev

接著將介面指向你的閘道 WS URL（例如 ws://127.0.0.1:18789）。

空白的控制介面頁面

如果瀏覽器載入空白儀表板，且開發人員工具未顯示有用的錯誤，可能是擴充功能或提早執行的內容指令碼阻止 JavaScript 模組應用程式進行求值。靜態頁面包含純 HTML 復原面板，當啟動後未註冊 <openclaw-app> 時便會顯示。

變更瀏覽器環境後，請使用面板中的 Try again 動作，或在完成下列檢查後手動重新載入：

• 停用會插入所有頁面的擴充功能，尤其是具有 <all_urls> 內容指令碼的擴充功能。
• 嘗試使用私密視窗、全新的瀏覽器設定檔或其他瀏覽器。
• 讓閘道持續執行，並在變更瀏覽器後驗證相同的儀表板 URL。

偵錯/測試：開發伺服器 + 遠端閘道

控制介面由靜態檔案組成；WebSocket 目標可設定，且可以不同於 HTTP 來源。當你想在本機使用 Vite 開發伺服器，但閘道在其他位置執行時，這會很方便。

pnpm ui:dev

http://localhost:5173/?gatewayUrl=ws%3A%2F%2F<gateway-host>%3A18789

http://localhost:5173/?gatewayUrl=wss%3A%2F%2F<gateway-host>%3A18789#token=<gateway-token>

{  gateway: {    controlUi: {      allowedOrigins: ["http://localhost:5173"],    },  },}

遠端存取設定詳細資訊：遠端存取。

相關內容

• 儀表板 — 閘道儀表板
• 健康狀態檢查 — 閘道健康狀態監控
• 終端介面 — 終端使用者介面
• WebChat — 瀏覽器聊天介面