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 chatopenclaw terminal 會叫用此命令,並隱含 --local

注意事項

  • --local 無法與 --url--token--password--tls-fingerprint 搭配使用。
  • 可能的情況下,tui 會解析已設定的閘道驗證 SecretRef,以供權杖/密碼驗證使用 (env/file/exec 提供者)。
  • 未明確指定 URL 或連接埠時,tui 會採用執行中閘道所記錄的作用中本機閘道連接埠。 明確指定的 --urlOPENCLAW_GATEWAY_URLOPENCLAW_GATEWAY_PORT 和遠端閘道設定仍具有較高優先順序。
  • 從已設定的代理程式工作區目錄內啟動時,終端介面會自動選取 該代理程式作為工作階段金鑰的預設值(除非明確將 --session 設為 agent:<id>:...)。
  • 本機模式會直接使用嵌入式代理程式執行階段。大多數本機工具都能運作, 但無法使用僅限閘道的功能。
  • 本機模式會將 /auth [provider] 新增至終端介面的命令介面。
  • 外掛核准閘門在本機模式下仍然適用:需要核准的工具 會在終端機中提示你做出決定,不會在未告知的情況下自動核准任何項目。
  • 工作階段目標會顯示在頁尾,並可使用 /goal 管理。

範例

bash
openclaw chatopenclaw tui --localopenclaw tuiopenclaw tui --url ws://127.0.0.1:18789 --token <token>openclaw tui --session main --deliveropenclaw chat --message "比較我的設定與文件,並告訴我該修正哪些地方"# 在代理程式工作區內執行時,會自動推斷該代理程式openclaw tui --session bugfix

設定修復迴圈

使用本機模式,讓嵌入式代理程式檢查目前的設定、與文件比較, 並協助你從同一個終端機進行修復。

如果 openclaw config validate 已經失敗,請先執行 openclaw configureopenclaw doctor --fixopenclaw chat 不會略過 無效設定防護。

bash
openclaw chat

接著在終端介面中執行:

text
!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctor

使用 openclaw config setopenclaw configure 套用針對性修正,然後 重新執行 openclaw config validate。請參閱終端介面設定

相關內容

Was this useful?
On this page

On this page