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?
本頁內容

本頁內容