CLI commands
終端介面
openclaw tui
開啟連線至閘道的終端介面，或以本機嵌入模式執行。
相關指南：終端介面
選項
| 旗標 | 預設值 | 說明 |
|---|---|---|
--local |
false |
使用本機嵌入式代理執行階段，而非閘道。 |
--url <url> |
設定中的 gateway.remote.url |
閘道 WebSocket URL。 |
--token <token> |
（無） | 閘道權杖（如有需要）。 |
--password <pass> |
（無） | 閘道密碼（如有需要）。 |
--tls-fingerprint <sha256> |
gateway.remote.tlsFingerprint |
已釘選 wss:// 閘道的預期 TLS 憑證指紋。 |
--session <key> |
main（範圍為全域時則為 global） |
工作階段金鑰。在代理工作區內，除非加上前綴，否則會自動選取該代理。 |
--deliver |
false |
透過已設定的頻道傳送助理回覆。 |
--thinking <level> |
（模型預設值） | 覆寫思考層級。 |
--message <text> |
（無） | 連線後傳送初始訊息。 |
--timeout-ms <ms> |
agents.defaults.timeoutSeconds |
代理逾時時間。無效值會記錄警告並予以忽略。 |
--history-limit <n> |
200 |
連接時要載入的歷史記錄項目數。 |
別名：openclaw chat 和 openclaw terminal 會呼叫此命令，並隱含使用 --local。
注意事項
--local無法與--url、--token、--password或--tls-fingerprint合併使用。- 在可行的情況下，
tui會解析已設定的閘道驗證 SecretRef，以供權杖／密碼驗證使用（env／file／exec提供者）。 - 若未明確指定 URL 或連接埠，
tui會使用執行中閘道所記錄的目前本機閘道連接埠。明確指定的--url、OPENCLAW_GATEWAY_URL、OPENCLAW_GATEWAY_PORT和遠端閘道設定仍具有較高優先順序。 - 從已設定的代理工作區目錄內啟動時，終端介面會自動選取該代理作為工作階段金鑰的預設值（除非明確將
--session設為agent:<id>:...）。 - 若要在頁尾顯示非本機 URL 連線所使用的閘道主機名稱，請執行
openclaw config set tui.footer.showRemoteHost true。預設為關閉；local loopback 或嵌入式本機連線一律不會顯示。 - 本機模式會直接使用嵌入式代理執行階段。大多數本機工具皆可運作，但僅限閘道的功能無法使用。
- 本機模式會在終端介面的命令介面中加入
/auth [provider]。 - 外掛核准閘門在本機模式下仍然適用：需要核准的工具會在終端機中提示您做出決定，不會在未提示的情況下自動核准任何項目。
- 工作階段目標會顯示於頁尾，並可使用
/goal管理。
範例
openclaw chatopenclaw tui --localopenclaw tuiopenclaw tui --url ws://127.0.0.1:18789 --token <token>openclaw tui --session main --deliveropenclaw chat --message "Compare my config to the docs and tell me what to fix"# 在代理工作區內執行時，會自動推斷該代理openclaw tui --session bugfix設定修復迴圈
使用本機模式，讓嵌入式代理檢查目前設定、與文件進行比較，並在同一個終端機中協助修復。
如果 openclaw config validate 已經失敗，請先執行 openclaw configure 或 openclaw doctor --fix；openclaw chat 不會略過無效設定防護機制。
openclaw chat接著在終端介面內執行：
!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctor使用 openclaw config set 或 openclaw configure 套用針對性修正，然後重新執行 openclaw config validate。請參閱終端介面和設定。
相關內容
Was this useful?
