Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw tui
開啟連接到 Gateway 的終端機 UI，或以本機嵌入模式執行。
相關：
- TUI 指南：TUI
選項
| 旗標 | 預設值 | 說明 |
|---|---|---|
--local | false | 對本機嵌入式代理程式執行階段執行，而不是 Gateway。 |
--url <url> | 來自設定的 gateway.remote.url | Gateway WebSocket URL。 |
--token <token> | （無） | Gateway 權杖（如有需要）。 |
--password <pass> | （無） | Gateway 密碼（如有需要）。 |
--session <key> | main（或範圍為全域時的 global） | 工作階段鍵。在代理程式工作區內，除非加上前綴，否則會自動選取該代理程式。 |
--deliver | false | 透過已設定的頻道傳遞助理回覆。 |
--thinking <level> | （模型預設值） | Thinking 等級覆寫。 |
--message <text> | （無） | 連線後傳送初始訊息。 |
--timeout-ms <ms> | agents.defaults.timeoutSeconds | 代理程式逾時。無效值會記錄警告並被忽略。 |
--history-limit <n> | 200 | 附加時要載入的歷史記錄項目數。 |
openclaw chat 和 openclaw terminal 會叫用相同命令，並隱含 --local。
注意事項：
chat和terminal是openclaw tui --local的別名。--local無法與--url、--token或--password結合使用。- 可能時，
tui會解析已設定的 Gateway 驗證 SecretRefs，以用於權杖/密碼驗證（env/file/exec提供者）。 - 從已設定的代理程式工作區目錄內啟動時，TUI 會自動選取該代理程式作為工作階段鍵預設值（除非
--session明確為agent:<id>:...）。 - 本機模式會直接使用嵌入式代理程式執行階段。大多數本機工具可用，但 Gateway 專屬功能無法使用。
- 本機模式會在 TUI 命令介面中加入
/auth [provider]。 - Plugin 核准閘門在本機模式中仍然適用。需要核准的工具會在終端機提示決策；不會因為未涉及 Gateway 就靜默自動核准任何項目。
範例
設定修復迴圈
當目前設定已通過驗證，而你想要嵌入式代理程式檢查它、將它與文件比較，並從同一個終端機協助修復時，請使用本機模式： 如果openclaw config validate 已經失敗，請先使用 openclaw configure 或 openclaw doctor --fix。openclaw chat 不會繞過無效設定防護。
openclaw config set 或 openclaw configure 套用目標修復，然後重新執行 openclaw config validate。請參閱 TUI 和 設定。