TUI（終端機介面）
OpenClaw 終端機使用者介面的說明文件，涵蓋快速入門、功能、鍵盤快捷鍵、斜線指令與疑難排解。
快速入門
openclaw gateway
openclaw tui遠端連線：
openclaw tui --url ws://<host>:<port> --token <gateway-token>也可使用密碼認證：
openclaw tui --url ws://<host>:<port> --password <gateway-password>畫面說明
介面顯示：
- 標題列：連線 URL、目前的 agent 與 session
- 聊天日誌：訊息與工具卡片
- 狀態列：連線狀態
- 頁尾：系統資訊與 token 計數
- 輸入編輯器：含自動完成功能
心智模型：agents + sessions
Agent 是唯一識別碼（例如：main、research）。Session 是 agent 專屬的，key 格式為 agent:<agentId>:<sessionKey>。範圍可以是「per-sender」（預設，每個 agent 有多個 session）或「global」（單一共用 session）。
傳送 + 遞送
訊息預設路由至 Gateway，不會遞送至供應商。透過 /deliver on、Settings 或啟動時的 --deliver 旗標啟用遞送。
選擇器 + 疊加層
介面包含模型、agent 和 session 選擇工具，以及用於切換遞送與顯示選項的 Settings 面板。
鍵盤快捷鍵
| 按鍵 | 功能 |
|---|---|
| Enter | 傳送訊息 |
| Esc | 中止執行中的回合 |
| Ctrl+C | 清除輸入 |
| Ctrl+D | 退出 |
| Ctrl+L | 模型選擇器 |
| Ctrl+G | Agent 選擇器 |
| Ctrl+P | Session 選擇器 |
| Ctrl+O | 切換工具輸出展開/收合 |
| Ctrl+T | 切換 thinking 可見性 |
斜線指令
核心指令：
/help、/status、/agent <id>、/session <key>、/model <provider/model>
Session 控制：
/think、/verbose、/reasoning、/usage、/elevated、/activation、/deliver
Session 生命週期：
/new、/reset、/abort、/settings、/exit
本機 shell 指令
以 ! 為前綴的行會執行本機 shell 指令。TUI 會在每個 session 中提示一次權限。指令在 TUI 工作目錄中的全新非互動式 shell 中執行。
工具輸出
工具呼叫顯示為包含引數與結果的卡片。部分更新在執行期間串流；使用者可在收合/展開檢視之間切換。
歷史記錄 + 串流
TUI 在連線時預設載入最多 200 則訊息。串流回應會即時更新，直到完成。
連線詳情
TUI 以 mode: "tui" 向 Gateway 註冊，並顯示重新連線訊息與事件間隙。
選項
| 選項 | 說明 |
|---|---|
--url | Gateway WebSocket URL |
--token | 認證 token |
--password | 密碼認證 |
--session | Session key（預設：main） |
--deliver | 啟用供應商遞送 |
--thinking | 覆寫 thinking 層級 |
--timeout-ms | Agent 逾時 |
--history-limit | 載入的歷史記錄條目數（預設 200） |
疑難排解
訊息無回應：
- 執行
/status驗證 Gateway 連線。 - 檢查日誌：
openclaw logs --follow。 - 確認 agent 運作正常：
openclaw agents list。 - 如需要，啟用遞送：
/deliver on。
連線問題：
- 驗證 Gateway 狀態：
openclaw gateway status。 - 確認憑證（token 或 password）正確。
Agent/session 選擇器為空：
- 檢查設定或路由問題。