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 指引；若可連線至已設定的閘道，則會以閘道模式開啟此終端介面殼層；否則，已設定的本機模型會以本機模式開啟此介面。

畫面內容

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

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

  • 代理程式以唯一的 slug 識別（例如 main、research）。閘道會公開此清單。

  • 工作階段屬於目前的代理程式。

  • 工作階段金鑰會儲存為 agent:<agentId>:<sessionKey>。

    • 如果輸入 /session main，終端介面會將其展開為 agent:<currentAgent>:main。
    • 如果輸入 /session agent:other:main，則會明確切換至該代理程式工作階段。

  • 工作階段範圍：

    • per-sender（預設）：每個代理程式可有多個工作階段。
    • global：終端介面一律使用 global 工作階段（選擇器可能為空白）。

  • 目前的代理程式與工作階段會一律顯示在頁尾。

  • 若要為非本機、以 URL 連線的閘道顯示主機，請使用以下設定啟用：

    bash
    openclaw config set tui.footer.showRemoteHost true

    預設值為 false。local loopback 與內嵌本機連線永遠不會顯示主機標籤。

  • 如果工作階段具有目標，頁尾會顯示其精簡狀態： 正在追求目標、目標已暫停（/goal resume）、目標受阻（/goal resume） 或 目標已達成。

  • 在未指定 --session 的情況下啟動時，若先前選取的工作階段仍然存在，閘道模式的終端介面會針對相同的閘道、代理程式及工作階段範圍恢復該工作階段。傳入 --session、/session、/new 或 /reset 仍屬於明確操作。

傳送 + 遞送

  • 訊息一律送往閘道（本機模式則送往內嵌執行階段）；將助理回覆遞送至聊天服務供應商則是另一個預設關閉的獨立步驟。
  • 終端介面與 WebChat 一樣是內部來源介面，不是通用的對外頻道。要求使用 tools.message 產生可見回覆的執行框架，可透過不指定目標的 message.send 滿足目前的終端介面輪次；明確的供應商遞送仍會使用一般已設定的頻道，且絕不會退回使用 lastChannel。
  • 遞送設定在啟動時即固定套用於整個終端介面工作階段：使用 openclaw tui --deliver 啟動即可開啟。沒有 /deliver 斜線命令或「設定」切換開關可在工作階段進行期間變更；若要變更，請重新啟動終端介面。

選擇器 + 覆疊面板

  • 模型選擇器：列出可用模型並設定工作階段覆寫值。
  • 代理程式選擇器：選擇其他代理程式。
  • 工作階段選擇器：顯示目前代理程式在過去 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>

工作階段生命週期：

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

僅限本機模式：

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

Crestodian：

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

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

本機殼層命令

  • 在一行開頭加上 !，即可在終端介面主機上執行本機殼層命令。
  • 終端介面會在每個工作階段中提示一次，以允許本機執行；若拒絕，該工作階段的 ! 將維持停用。
  • 命令會在終端介面工作目錄中的全新非互動式殼層內執行（不會保留 cd／環境變數）。
  • 本機殼層命令的環境中會包含 OPENCLAW_SHELL=tui-local。
  • 單獨的 ! 會當作一般訊息傳送；前置空格不會觸發本機執行。

Crestodian 設定與修復協助工具

Crestodian 是零環層級的設定／修復助理；設定的預設模型通過即時推論檢查後，即可透過 openclaw crestodian 使用。如果推論無法使用，互動式呼叫會返回推論初始設定，而自動化操作則會失敗並提供修復指引。它與 openclaw tui --local 在相同的本機終端介面殼層中執行，背後由僅能使用 Crestodian 型別化且需經核准操作的 AI 代理程式提供支援：

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

當目前的設定已通過驗證，且你希望內嵌代理程式在同一台機器上檢查設定、與文件比較，並在不依賴執行中閘道的情況下協助修復設定偏移時，請使用本機模式。

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

典型流程：

  1. 啟動本機模式：
bash
openclaw chat
  1. 告訴代理程式你想檢查的內容，例如：
text
請將我的閘道驗證設定與文件比較，並建議最小幅度的修正。
  1. 使用本機殼層命令取得精確證據並進行驗證：
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，或 local loopback 上的 ws://127.0.0.1:<port>）
  • --token <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