English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

CLI commands

日誌

openclaw logs

透過 RPC 追蹤 Gateway 檔案日誌（可在遠端模式運作）。

相關：

選項

  • --limit <n>：要傳回的日誌行數上限（預設 200）
  • --max-bytes <n>：要從日誌檔讀取的位元組上限（預設 250000）
  • --follow：跟隨日誌串流
  • --interval <ms>：跟隨時的輪詢間隔（預設 1000）
  • --json：輸出以行分隔的 JSON 事件
  • --plain：不含樣式格式的純文字輸出
  • --no-color：停用 ANSI 色彩
  • --local-time：以你的本機時區呈現時間戳記

共用 Gateway RPC 選項

openclaw logs 也接受標準 Gateway 用戶端旗標：

  • --url <url>：Gateway WebSocket URL
  • --token <token>：Gateway token
  • --timeout <ms>：逾時毫秒數（預設 30000）
  • --expect-final：當 Gateway 呼叫由代理程式支援時，等待最終回應

傳入 --url 時，CLI 不會自動套用設定或環境認證。如果目標 Gateway 需要驗證，請明確包含 --token。

範例

openclaw logs
openclaw logs --follow
openclaw logs --follow --interval 2000
openclaw logs --limit 500 --max-bytes 500000
openclaw logs --json
openclaw logs --plain
openclaw logs --no-color
openclaw logs --limit 500
openclaw logs --local-time
openclaw logs --follow --local-time
openclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

注意事項

  • 使用 --local-time 以你的本機時區呈現時間戳記。
  • 如果隱含的 local loopback Gateway 要求配對、在連線期間關閉，或在 logs.tail 回應前逾時，openclaw logs 會自動退回使用已設定的 Gateway 檔案日誌。明確的 --url 目標不會使用此備援。
  • 使用 --follow 時，暫時性的 Gateway 斷線（WebSocket 關閉、逾時、連線中斷）會觸發使用指數退避的自動重新連線（最多 8 次重試，嘗試間隔上限為 30 秒）。每次重試都會將警告列印到 stderr，且一旦輪詢成功，就會列印 [logs] gateway reconnected 通知。在 --json 模式中，重試警告與重新連線轉換都會以 {"type":"notice"} 記錄輸出到 stderr。不可復原的錯誤（驗證失敗、錯誤設定）仍會立即結束。

相關