CLI commands

セッション

`openclaw sessions`

保存されている会話セッションを一覧表示します。

セッション一覧は、チャネルやプロバイダーの稼働確認ではありません。セッションストアに永続化された会話行を表示します。通信のない Discord、Slack、Telegram、またはその他のチャネルは、メッセージが処理されて新しいセッション行が作成される前でも、正常に再接続できます。チャネルの接続状態をリアルタイムで確認する必要がある場合は、 openclaw channels status --probe、openclaw status --deep、または openclaw health --verbose を使用してください。

bash

openclaw sessionsopenclaw sessions --agent workopenclaw sessions --all-agentsopenclaw sessions --active 120openclaw sessions --limit 25openclaw sessions --store ./tmp/sessions.jsonopenclaw sessions --json

フラグ:

フラグ	説明
`--agent <id>`	構成済みのエージェントストアを1つ指定します（デフォルト: 構成済みのデフォルトエージェント）。
`--all-agents`	構成済みのすべてのエージェントストアを集約します。
`--store <path>`	明示的なストアパスを指定します（`--agent` または `--all-agents` と併用不可）。
`--active <minutes>`	過去 N 分以内に更新されたセッションのみを表示します。
`--limit <n\|all>`	出力する最大行数（デフォルトは `100`。`all` で全件出力に戻します）。
`--json`	機械可読形式で出力します。
`--verbose`	詳細なログを出力します。

openclaw sessions と Gateway の sessions.list RPC は、大規模で長期間使用されるストアが CLI プロセスや Gateway のイベントループを占有しないよう、デフォルトで件数が制限されています。CLI はデフォルトで最新の100セッションを返します。より小さい、または大きい範囲には --limit <n> を指定し、意図的にストア全体が必要な場合は --limit all を指定してください。JSON レスポンスには、呼び出し元が追加の行の存在を示せるように、totalCount、limitApplied、hasMore が含まれます。

RPC クライアントは configuredAgentsOnly: true を渡すことで、広範な統合検出ソースを維持しつつ、現在構成に存在するエージェントの行のみを返せます。 Control UI はデフォルトでこのモードを使用するため、削除済みまたはディスク上にのみ存在するエージェントストアが Sessions ビューに再表示されることはありません。

--all-agents は構成済みのエージェントストアを読み取ります。Gateway と ACP のセッション検出はより広範で、構成済みのエージェントルートまたはテンプレート化された session.store ルートから解決された SQLite ストアも含まれます。従来のセレクターパスはエージェントルート内に解決される必要があり、シンボリックリンクとルート外のパスはスキップされます。

openclaw sessions --all-agents --json:

json

{  "path": null,  "stores": [    { "agentId": "main", "path": "/home/user/.openclaw/agents/main/sessions/sessions.json" },    { "agentId": "work", "path": "/home/user/.openclaw/agents/work/sessions/sessions.json" }  ],  "allAgents": true,  "count": 2,  "totalCount": 2,  "limitApplied": 100,  "hasMore": false,  "activeMinutes": null,  "sessions": [    { "agentId": "main", "key": "agent:main:main", "model": "openai/gpt-5.6-sol" },    { "agentId": "work", "key": "agent:work:main", "model": "anthropic/claude-sonnet-4-6" }  ]}

軌跡の進捗を追跡する

bash

openclaw sessions tailopenclaw sessions tail --followopenclaw sessions tail --session-key "agent:main:telegram:direct:123" --tail 25openclaw sessions --agent work tail --followopenclaw sessions --all-agents tail --follow

openclaw sessions tail は、最近のランタイム軌跡イベントを簡潔な進捗行として表示します。--session-key を指定しない場合、まず実行中のセッションを追跡し、その後保存されている最新のセッションを追跡します。--tail <count> は、追跡モードの開始前に出力する既存イベントの数を制御します。デフォルトは 80 で、0 を指定すると現在の末尾から開始します。 --follow は、選択した SQLite ベースのセッション、または明示的に指定した従来の軌跡ファイルを継続して監視します。

進捗ビューは意図的に控えめな表示になっています。プロンプトテキスト、ツール引数、ツール結果の本文は出力されません。ツール呼び出しはツール名と {...redacted...} を表示し、ツール結果は ok、error、done などのステータスを表示し、モデル完了行はプロバイダー、モデル、終了ステータスを表示します。

軌跡バンドルをエクスポートする

bash

openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace .openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --output bug-123 --json

これは、所有者が実行リクエストを承認した後に /export-trajectory スラッシュコマンドが使用するコマンドパスです。出力ディレクトリは、選択したワークスペース配下の .openclaw/trajectory-exports/ 内に必ず解決されます。

クリーンアップメンテナンス

次の書き込みサイクルを待たずに、今すぐメンテナンスを実行します。

bash

openclaw sessions cleanup --dry-runopenclaw sessions cleanup --agent work --dry-runopenclaw sessions cleanup --all-agents --dry-runopenclaw sessions cleanup --enforceopenclaw sessions cleanup --enforce --active-key "agent:main:telegram:direct:123"openclaw sessions cleanup --dry-run --fix-dm-scopeopenclaw sessions cleanup --json

openclaw sessions cleanup は、構成の session.maintenance 設定（構成リファレンス）を使用します。

対象範囲に関する注記: openclaw sessions cleanup は、セッションストア、トランスクリプト、軌跡行、従来の軌跡サイドカーをメンテナンスします。 cron.runLog.keepLines で管理される Cron 実行履歴は削除しません（Cron の構成）。
クリーンアップでは、参照されていない従来形式またはアーカイブ済みのトランスクリプト成果物、 Compaction チェックポイント、および session.maintenance.pruneAfter より古い軌跡サイドカーも削除します。SQLite のセッション行から引き続き参照されている成果物は保持されます。
クリーンアップでは、短期間のみ存在する Gateway モデル実行プローブのクリーンアップを modelRunPruned として個別に報告します。これは、 agent:*:explicit:model-run-<uuid> 形式の厳密かつ明示的なキーにのみ一致します。保持期間は固定で 24h であり、負荷条件に基づいて実行されます。セッションエントリのメンテナンスまたは上限制約が発生した場合にのみ、古いプローブ行を削除します。実行時には、モデル実行のクリーンアップがグローバルな古いデータのクリーンアップと上限適用より先に行われます。

フラグ:

フラグ	説明
`--dry-run`	書き込みを行わず、削除または上限適用されるエントリ数をプレビューします。テキストモードでは、セッションごとのアクション表（`Action`、`Key`、`Age`、`Model`、`Flags`）と、セッションラベル別にグループ化した概要を出力します。
`--enforce`	`session.maintenance.mode` が `warn` の場合でもメンテナンスを適用します。
`--fix-missing`	アーカイブ済みトランスクリプト成果物が欠落しているか、ヘッダーのみまたは空である従来のエントリを、通常の経過時間や件数による削除対象でなくても削除します。
`--fix-dm-scope`	`session.dmScope` が `main` の場合、以前の `per-peer`、`per-channel-peer`、または `per-account-channel-peer` ルーティングによって残された、古いピアキー形式のダイレクト DM 行を廃止します。最初に `--dry-run` を使用してください。適用すると、それらの行を SQLite から削除し、従来のトランスクリプト成果物を削除済みアーカイブとして保持します。
`--active-key <key>`	特定のアクティブキーをディスク容量上限による退避から保護します。グループセッションやスレッド単位のチャットセッションなど、永続的な外部会話ポインターも、経過時間、件数、ディスク容量上限に基づくメンテナンスで保持されます。
`--agent <id>`	構成済みのエージェントストアを1つ指定してクリーンアップを実行します。
`--all-agents`	構成済みのすべてのエージェントストアに対してクリーンアップを実行します。
`--store <path>`	特定の従来ストアのセレクターパスに対して実行します。
`--json`	JSON 形式の概要を出力します。`--all-agents` を指定した場合、ストアごとの概要が1つずつ出力されます。

Gateway に到達できる場合、構成済みエージェントストアに対するドライラン以外のクリーンアップは Gateway を経由して送信され、ランタイムトラフィックと同じセッションストアライターを共有します。従来ストアのセレクターを明示的にオフライン修復する場合は、 --store <path> を使用してください。

openclaw sessions cleanup --all-agents --dry-run --json:

json

{  "allAgents": true,  "mode": "warn",  "dryRun": true,  "stores": [    {      "agentId": "main",      "storePath": "/home/user/.openclaw/agents/main/sessions/sessions.json",      "beforeCount": 120,      "afterCount": 80,      "missing": 0,      "dmScopeRetired": 0,      "pruned": 40,      "capped": 0    },    {      "agentId": "work",      "storePath": "/home/user/.openclaw/agents/work/sessions/sessions.json",      "beforeCount": 18,      "afterCount": 18,      "missing": 0,      "dmScopeRetired": 0,      "pruned": 0,      "capped": 0    }  ]}