OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Web interfaces

終端介面

快速開始

閘道模式

  1. 啟動閘道。
bash
openclaw gateway
  1. 開啟終端介面。
bash
openclaw tui
  1. 輸入訊息並按下 Enter。

遠端閘道：

bash
openclaw tui --url ws://<host>:<port> --token <gateway-token>

如果你的閘道使用密碼驗證，請使用 --password。

本機模式

不透過閘道執行終端介面：

bash
openclaw chat# 或openclaw tui --local
  • openclaw chat 和 openclaw terminal 是 openclaw tui --local 的別名。
  • --local 無法與 --url、--token 或 --password 搭配使用。
  • 本機模式會直接使用內嵌的代理程式執行階段。大多數本機工具皆可運作，但僅限閘道的功能無法使用。
  • 單獨執行 openclaw（不含子命令）時，會自動選擇目標：尚未設定的安裝會執行推論引導設定；無效的設定會開啟傳統 Doctor 指引；若已設定且可連線的閘道存在，會以閘道模式開啟此終端介面 shell；否則，已設定的本機模型會以本機模式開啟。

畫面內容

  • 標頭：連線 URL、目前的代理程式、目前的工作階段。
  • 聊天記錄：使用者訊息、助理回覆、系統通知、工具卡片。
  • 狀態列：連線／執行狀態（連線中、執行中、串流中、閒置、錯誤）。
  • 頁尾：代理程式 + 工作階段 + 模型 + 目標狀態 + 思考／快速／詳細／追蹤／推理 + 權杖計數 + 傳送。
  • 輸入區：具備自動完成的文字編輯器。

心智模型：代理程式 + 工作階段

  • 代理程式是唯一的 slug（例如 main、research）。閘道會提供此清單。
  • 工作階段屬於目前的代理程式。
  • 工作階段金鑰會儲存為 agent:<agentId>:<sessionKey>。
    • 如果你輸入 /session main，終端介面會將其展開為 agent:<currentAgent>:main。
    • 如果你輸入 /session agent:other:main，便會明確切換至該代理程式工作階段。
  • 工作階段範圍：
    • per-sender（預設）：每個代理程式都有多個工作階段。
    • global：終端介面一律使用 global 工作階段（選擇器可能是空的）。
  • 目前的代理程式 + 工作階段一律顯示於頁尾。
  • 如果工作階段有目標，頁尾會顯示其精簡狀態： Pursuing goal、Goal paused (/goal resume)、Goal blocked (/goal resume) 或 Goal achieved。
  • 在未指定 --session 的情況下啟動時，如果先前選取的工作階段仍然存在，閘道模式終端介面會針對相同的閘道、代理程式與工作階段範圍，繼續使用該工作階段。傳入 --session、/session、/new 或 /reset 時仍會明確指定。

傳送 + 遞送

  • 訊息一律傳送至閘道（或本機模式中的內嵌執行階段）；將助理的回覆向外遞送至聊天服務供應商則是獨立步驟，預設為關閉。
  • 終端介面是類似 WebChat 的內部來源介面，而非一般的對外傳出頻道。需要 tools.message 才能顯示回覆的框架，可以使用不指定目標的 message.send 來完成目前的終端介面輪次；明確的服務供應商遞送仍會使用一般已設定的頻道，且絕不會退回使用 lastChannel。
  • 整個終端介面工作階段的遞送設定會在啟動時固定：使用 openclaw tui --deliver 啟動即可開啟。沒有可在工作階段進行期間切換的 /deliver 斜線命令或 Settings 開關；若要變更，請重新啟動終端介面。

選擇器 + 疊加面板

  • 模型選擇器：列出可用模型並設定工作階段覆寫。
  • 代理程式選擇器：選擇其他代理程式。
  • 工作階段選擇器：顯示目前代理程式在最近 7 天內更新的最多 50 個工作階段。使用 /session <key> 可跳至較舊的已知工作階段。
  • 設定（/settings）：切換工具輸出展開狀態與思考內容的可見性。此面板不控制遞送。

鍵盤快速鍵

  • Enter：傳送訊息
  • Esc：中止進行中的執行
  • Ctrl+C：清除輸入（按兩次即可結束）
  • Ctrl+D：結束
  • Ctrl+L：模型選擇器
  • Ctrl+G：代理程式選擇器
  • Ctrl+P：工作階段選擇器
  • Ctrl+O：切換工具輸出展開狀態
  • Ctrl+T：切換思考內容可見性（會重新載入歷程記錄）

斜線命令

核心：

  • /help
  • /status（轉送至閘道；顯示工作階段／模型摘要）
  • /gateway-status（別名 /gwstatus；直接顯示閘道連線狀態）
  • /agent <id>（或 /agents）
  • /session <key>（或 /sessions）
  • /model <provider/model>（或 /models）

工作階段控制：

  • /think <off|minimal|low|medium|high>（視模型而定，較高層級可能會加入 xhigh/max 等等級）
  • /fast <status|auto|on|off>
  • /verbose <on|full|off>
  • /trace <on|off>
  • /reasoning <on|off|stream>
  • /usage <off|tokens|full|reset>（reset/inherit/clear/default 會清除工作階段覆寫）
  • /goal [status] | /goal start <objective> | /goal edit <objective> | /goal pause|resume|complete|block|clear
  • /elevated <on|off|ask|full>（別名：/elev）
  • /activation <mention|always>
  • /queue <steer|followup|collect|interrupt> [debounce:<duration>] [cap:<n>] [drop:<summarize|old|new>]
  • /queue default（或 /queue reset）會清除工作階段覆寫

工作階段生命週期：

  • /new（使用新金鑰建立全新且隔離的工作階段；不會影響舊工作階段上的其他終端介面用戶端）
  • /reset（就地重設目前的工作階段金鑰）
  • /abort（中止進行中的執行）
  • /settings
  • /exit（或 /quit）

僅限本機模式：

  • /auth [provider] 會在終端介面內開啟服務供應商驗證／登入流程。

本機模式會在內嵌執行階段內實作相同的佇列模式。執行期間收到的 提示會遵循工作階段的 /queue 原則：當執行階段可接受提示時， steer 會將其插入；followup 會等待另一個獨立輪次；collect 會合併 待處理的提示；而 interrupt 會先停止目前的執行，再開始新的 執行。明確的 /steer <message> 僅限閘道使用；在本機模式中，請使用 /queue steer 加上 一般訊息。

OpenClaw：

  • /openclaw [request] 會從一般代理程式終端介面返回 OpenClaw 設定／修復聊天，並可選擇轉送一項要求。

其他閘道斜線命令（例如 /context）會轉送至閘道，並顯示為系統輸出。請參閱斜線命令。

本機 shell 命令

  • 在一行開頭加上 !，即可在終端介面主機上執行本機 shell 命令。
  • 終端介面會在每個工作階段提示一次，詢問是否允許本機執行；若拒絕，該工作階段會保持停用 !。
  • 命令會在終端介面的工作目錄中，以全新且非互動式的 shell 執行（不會保留 cd/env）。
  • 本機 shell 命令會在其環境中收到 OPENCLAW_SHELL=tui-local。
  • 單獨的 ! 會作為一般訊息傳送；前置空格不會觸發本機執行。

OpenClaw 設定與修復輔助工具

OpenClaw 是 ring-zero 設定／修復助理，在已設定的預設模型通過即時推論檢查後，會以 openclaw setup 提供。如果無法進行推論，互動式叫用會返回推論引導設定，而自動化則會失敗並提供修復指引。它會在與 openclaw tui --local 相同的本機終端介面 shell 中執行，由一個僅能執行 OpenClaw 型別化且需核准操作的 AI 代理程式提供支援：

bash
openclaw setup                       # 以互動方式啟動openclaw setup -m "status"           # 執行一項要求後結束openclaw setup -m "set default model openai/gpt-5.2" --yes   # 套用設定寫入
  • 持久性設定寫入需要核准：請在互動模式中確認，或傳入 --yes。
  • --json 會以 JSON 格式輸出啟動概覽，而不會開始聊天。
  • 在 OpenClaw 內，open-tui 要求（例如要求與一般代理程式交談）會結束 OpenClaw 並開啟一般代理程式終端介面；在該處使用 /openclaw 即可返回。

如果目前的設定已驗證通過，而你想讓內嵌代理程式在同一台機器上檢查設定、與文件比對，並協助修復偏差，而不依賴執行中的閘道，請使用本機模式。

如果 openclaw config validate 已經失敗，請先從 openclaw configure 或 openclaw doctor --fix 開始；openclaw chat 仍需可載入的設定才能啟動。

典型流程：

  1. 啟動本機模式：
bash
openclaw chat
  1. 告訴代理程式你想檢查的項目，例如：
text
將我的閘道驗證設定與文件比較，並建議最小幅度的修正。
  1. 使用本機 shell 命令取得確切證據並進行驗證：
text
!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctor
  1. 使用 openclaw config set 或 openclaw configure 套用小範圍變更，然後重新執行 !openclaw config validate。
  2. 如果 Doctor 建議自動遷移或修復，請先檢視，再執行 !openclaw doctor --fix。

提示：

  • 優先使用 openclaw config set 或 openclaw configure，而非手動編輯 openclaw.json。
  • openclaw docs "<query>" 會從同一台機器搜尋即時文件索引。
  • 當你需要結構化結構描述與 SecretRef／可解析性錯誤時，openclaw config validate --json 很實用。

工具輸出

  • 工具呼叫會顯示為包含引數 + 結果的卡片。
  • Ctrl+O 可在收合／展開檢視之間切換。
  • 工具執行時，部分更新會串流至同一張卡片。

終端機色彩

  • 終端介面會讓助理本文使用終端機的預設前景色，使深色和淺色終端機都能保持易讀。
  • 如果你的終端機使用淺色背景，但自動偵測結果錯誤，請在啟動 openclaw tui 前設定 OPENCLAW_THEME=light。
  • 若要改為強制使用原始深色調色盤，請設定 OPENCLAW_THEME=dark。

歷程記錄 + 串流

  • 連線時，終端介面會載入最新的歷程記錄（預設 200 則訊息）。
  • 串流回應會就地更新，直到完成為止。
  • 終端介面也會監聽代理程式工具事件，以提供內容更豐富的工具卡片。

連線詳細資料

  • 終端介面會使用用戶端 ID openclaw-tui，並在粗略的 ui 用戶端模式下連線（Control UI 和 WebChat 也使用相同模式套用閘道原則）。
  • 重新連線時會顯示系統訊息；事件缺漏會呈現在記錄中。

選項

  • --local：針對本機嵌入式代理程式執行階段執行
  • --url <url>：閘道 WebSocket URL（預設為設定中的 gateway.remote.url，或回送介面上的 ws://127.0.0.1:<port>）
  • --token <token>：閘道權杖（如有需要）
  • --password <password>：閘道密碼（如有需要）
  • --tls-fingerprint <sha256>：固定 wss:// 閘道預期的 TLS 憑證指紋
  • --session <key>：工作階段金鑰（預設：main；範圍為全域時則為 global）
  • --deliver：將助理回覆傳送給提供者（預設關閉）
  • --thinking <level>：覆寫傳送時的思考層級
  • --message <text>：連線後傳送初始訊息
  • --timeout-ms <ms>：代理程式逾時毫秒數（預設為 agents.defaults.timeoutSeconds）
  • --history-limit <n>：要載入的歷史記錄項目數（預設為 200）

疑難排解

傳送訊息後沒有輸出：

  • 在終端介面中執行 /status，確認閘道已連線且處於閒置或忙碌狀態。
  • 檢查閘道記錄：openclaw logs --follow。
  • 確認代理程式可以執行：openclaw status 和 openclaw models status。
  • 若預期訊息出現在聊天頻道中，請確認啟動終端介面時已指定 --deliver（若未重新啟動，之後無法開啟此功能）。

連線疑難排解

  • disconnected：確認閘道正在執行，且你的 --url/--token/--password 正確。
  • 選擇器中沒有代理程式：請檢查 openclaw agents list 和你的路由設定。
  • 工作階段選擇器為空：你可能處於全域範圍，或尚無任何工作階段。

相關內容

Was this useful?
On this page

On this page