openclaw logs
RPC 経由で Gateway のファイルログを追尾します。リモートモードで動作します。
オプション
--limit <n>: 返すログ行の最大数(デフォルト200)--max-bytes <n>: ログファイルから読み取る最大バイト数(デフォルト250000)--follow: ログストリームを追尾--interval <ms>: 追尾中のポーリング間隔(デフォルト1000)--json: 行区切りの JSON イベントを出力--plain: スタイル付き書式なしのプレーンテキスト出力--no-color: ANSI カラーを無効化--local-time: タイムスタンプをローカルタイムゾーンで表示(デフォルト)--utc: タイムスタンプを UTC で表示
共有 Gateway RPC オプション
--url <url>: Gateway WebSocket URL--token <token>: Gateway トークン--timeout <ms>: タイムアウト(ミリ秒、デフォルト30000)--expect-final: Gateway 呼び出しがエージェント支援の場合、最終レスポンスを待機
--url を渡すと、自動適用される設定済み認証情報はスキップされます。対象の Gateway が認証を必要とする場合は、--token を明示的に含めてください。
例
フォールバックと復旧動作
- 暗黙の local loopback Gateway がペアリングを要求した場合、接続中に閉じた場合、または
logs.tailが応答する前にタイムアウトした場合、openclaw logsは設定済みの Gateway ファイルログへ自動的にフォールバックします。明示的な--urlターゲットでは、このフォールバックは使用されません。 --followは、暗黙のローカル Gateway RPC 障害後にその設定済みファイルへフォールバックしません。古い横置きファイルがライブ追尾を誤解させる可能性があるためです。Linux では代わりに、利用可能な場合は PID によってアクティブな user-systemd Gateway ジャーナルを使用します(選択されたソースを出力します)。それ以外の場合は、ライブ Gateway への再試行を続けます。--follow中、一時的な切断(WebSocket の close、タイムアウト、接続断)は、指数バックオフによる自動再接続をトリガーします。最大 8 回再試行し、試行間隔は最大 30 秒です。各再試行で stderr に警告が出力され、ポーリングが成功すると[logs] gateway reconnected通知が 1 回出力されます。--jsonモードでは、どちらも stderr に{"type":"notice"}レコードとして出力されます。復旧不能なエラー(認証失敗、不正な設定)は引き続き即座に終了します。--follow --jsonモードでは、ログソースの遷移が{"type":"meta"}レコードとして出力されます。カーソルはsourceKindごとに追跡してください。ストリームは Gateway ファイル出力(sourceKind: "file")からローカルジャーナルフォールバック(sourceKind: "journal"、localFallback: true、service.pid/service.unit付き)へ移動し、復旧後に Gateway ファイル出力へ戻ることがあります。セッション全体で単一の安定したソースやカーソルがあると仮定せず、復旧時に Gateway ファイルカーソルが再生されて行が重複することを許容してください。