CLI commands

セッション

`openclaw sessions`

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

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

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

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

bash

openclaw sessionsopenclaw sessions --agent workopenclaw sessions --all-agentsopenclaw sessions --active 120openclaw sessions --limit 25openclaw sessions --verboseopenclaw sessions --json

スコープ選択:

デフォルト: 設定済みのデフォルトエージェントストア
--verbose: 詳細ログ
--agent <id>: 1 つの設定済みエージェントストア
--all-agents: すべての設定済みエージェントストアを集約
--store <path>: 明示的なストアパス（--agent または --all-agents と組み合わせ不可）
--limit <n|all>: 出力する最大行数（デフォルトは 100; all は完全な出力を復元）

保存済みセッションの人間が読める trajectory 進行状況を tail します:

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 は、最近の trajectory JSONL イベントをコンパクトな進行状況行として描画します。--session-key がない場合、まず実行中のセッションを tail し、その後最新の保存済みセッションを tail します。--tail <count> は follow モードの前に出力する既存イベント数を制御します。デフォルトは 80 で、0 は現在の末尾から開始します。--follow は、<session>.trajectory-path.json によって参照される移動済みファイルを含め、選択された trajectory ファイルを監視し続けます。

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

保存済みセッションの trajectory バンドルをエクスポートします:

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

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

openclaw sessions --all-agents は設定済みエージェントストアを読み取ります。Gateway と ACP のセッションディスカバリーはより広く、デフォルトの agents/ ルートまたはテンプレート化された session.store ルート配下で見つかった、ディスク上にのみ存在するストアも含みます。これらの検出されたストアは、エージェントルート内の通常の sessions.json ファイルに解決される必要があります。シンボリックリンクとルート外パスはスキップされます。

JSON の例:

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": "gpt-5" },    { "agentId": "work", "key": "agent:work:main", "model": "claude-opus-4-6" }  ]}

クリーンアップ保守

次の書き込みサイクルを待たずに、今すぐ保守を実行します:

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 は config の session.maintenance 設定を使用します:

スコープの注記: openclaw sessions cleanup はセッションストア、トランスクリプト、trajectory サイドカーを保守します。Cron 実行履歴は削除しません。これは Cron 設定の cron.runLog.keepLines によって管理され、Cron 保守で説明されています。
クリーンアップは、session.maintenance.pruneAfter より古い未参照のプライマリトランスクリプト、Compaction チェックポイント、trajectory サイドカーも削除します。sessions.json からまだ参照されているファイルは保持されます。
クリーンアップは、短命の gateway model-run probe クリーンアップを modelRunPruned として別に報告します。これは agent:*:explicit:model-run-<uuid> のような厳密で明示的なキーにのみ一致します。固定保持期間は 24h ですが、これは負荷条件付きです。セッションエントリーの保守/上限圧力に達した場合にのみ、古い probe 行を削除します。実行される場合、model-run クリーンアップはグローバルな古いエントリーのクリーンアップと上限制御の前に行われます。
--dry-run: 書き込まずに、削除/上限制御されるエントリー数をプレビューします。
- テキストモードでは、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 ルーティングによって残された古い peer-keyed direct-DM 行を退役させます。まず --dry-run を使用してください。クリーンアップを適用すると、それらの行は sessions.json から削除され、トランスクリプトは削除済みアーカイブとして保持されます。
--active-key <key>: 特定のアクティブキーをディスク予算による退避から保護します。グループセッションやスレッドスコープのチャットセッションなど、永続的な外部会話ポインターも、経過時間/件数/ディスク予算の保守で保持されます。
--agent <id>: 1 つの設定済みエージェントストアに対してクリーンアップを実行します。
--all-agents: すべての設定済みエージェントストアに対してクリーンアップを実行します。
--store <path>: 特定の sessions.json ファイルに対して実行します。
--json: JSON 概要を出力します。--all-agents と併用すると、出力にはストアごとの概要が 1 つずつ含まれます。

Gateway に到達できる場合、設定済みエージェントストアに対する dry-run ではないクリーンアップは 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    }  ]}