メインコンテンツへスキップ
OpenClaw は、すべての受信メッセージを送信元に基づいて セッション にルーティングします: DM、グループチャット、Cron ジョブなど。すべてのセッション状態は Gateway が所有し、UI クライアントはセッションデータを Gateway に問い合わせます。

​
メッセージのルーティング方法

送信元動作
ダイレクトメッセージデフォルトで共有セッション
グループチャットグループごとに分離
ルーム/チャンネルルームごとに分離
Cron ジョブ実行ごとに新規セッション
Webhookフックごとに分離

​
DM 分離

デフォルトでは、継続性のためすべての DM が 1 つのセッションを共有します。これは 単一ユーザーのセットアップでは問題ありません。
複数の人がエージェントにメッセージを送れる場合は、DM 分離を有効にしてください。有効にしないと、すべての ユーザーが同じ会話コンテキストを共有するため、Alice のプライベートメッセージが Bob に見えてしまいます。
{
  session: {
    dmScope: "per-channel-peer", // isolate by channel + sender
  },
}
session.dmScope のオプション:
値動作
main (デフォルト)すべての DM が 1 つのセッションを共有
per-peer送信者ごとに分離し、チャンネルをまたぐ
per-channel-peerチャンネル + 送信者ごとに分離 (推奨)
per-account-channel-peerアカウント + チャンネル + 送信者ごとに分離
同じ人が複数のチャンネルから連絡してくる場合は、 session.identityLinks を使って各 ID を 1 つの正規ピア ID にマッピングし、 セッションを共有させます。

​
リンク済みチャンネルのドック

ドックコマンドは、新しいセッションを開始せずに、現在のダイレクトチャットセッションの返信先ルートを別の リンク済みチャンネルへ移動します。例、設定、 トラブルシューティングについては チャンネルドッキング を参照してください。 openclaw security audit でセットアップを検証してください。

​
セッションのライフサイクル

セッションは session.reset によって期限切れになるまで再利用されます:
  • 日次リセット (デフォルト mode: "daily") - Gateway ホスト上の設定済みローカル 時刻 (session.reset.atHour、デフォルト 4、0-23) に新しいセッションを開始します。日次の 新鮮さは、後続のメタデータ書き込みではなく、現在の sessionId が開始した時点に基づきます。
  • アイドルリセット (mode: "idle") - session.reset.idleMinutes の非アクティブ時間後に新しいセッションを開始します。アイドルの新鮮さは最後の実際のユーザー/チャンネル 操作に基づくため、Heartbeat、Cron、exec システムイベントは セッションを維持しません。
  • 手動リセット - チャットで /new または /reset と入力します。/new <model> は モデルも切り替えます。
日次リセットとアイドルリセットの両方が設定されている場合は、先に期限切れになった方が優先されます。 Heartbeat、Cron、exec、その他のシステムイベントターンはセッションメタデータを書き込むことがありますが、 これらの書き込みは日次またはアイドルリセットの新鮮さを延長しません。リセットによって セッションが切り替わると、古いセッションのキュー済みシステムイベント通知は破棄されるため、 古いバックグラウンド更新が新しいセッションの最初のプロンプトの前に追加されることはありません。 プロバイダー所有の CLI セッションがアクティブなセッションは、暗黙の日次デフォルトでは切られません。 それらのセッションをタイマーで期限切れにする必要がある場合は、/reset を使うか session.reset を明示的に設定してください。 チャット種別ごと、またはチャンネルごとにデフォルトを上書きします: 
{
  session: {
    reset: { mode: "daily", atHour: 4 },
    resetByType: {
      group: { mode: "idle", idleMinutes: 120 },
      thread: { mode: "daily", atHour: 6 },
    },
    resetByChannel: {
      discord: { mode: "idle", idleMinutes: 10080 },
    },
  },
}
resetByType は direct (レガシーエイリアス dm)、group、thread をサポートします。 レガシーのトップレベル session.idleMinutes は、session.reset/resetByType ブロックが設定されていない場合に、 アイドルモードのデフォルトに対する互換エイリアスとして引き続き機能します。

​
状態の保存場所

  • ストア: ~/.openclaw/agents/<agentId>/sessions/sessions.json
  • トランスクリプト: ~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl
sessions.json は個別のライフサイクルタイムスタンプを保持します:
  • sessionStartedAt: 現在の sessionId が開始した時刻。日次リセットはこれを使用します。
  • lastInteractionAt: アイドル存続期間を延長する最後のユーザー/チャンネル操作。
  • updatedAt: 最後のストア行の変更時刻。一覧表示や pruning に役立ちますが、 日次/アイドルリセットの新鮮さについての正規情報ではありません。
sessionStartedAt がない古い行は、利用可能な場合、トランスクリプト JSONL の セッションヘッダーから解決されます。古い行に lastInteractionAt もない場合、 アイドルの新鮮さは後続の記録管理書き込みではなく、そのセッション開始時刻にフォールバックします。

​
セッションメンテナンス

OpenClaw は session.maintenance によって時間の経過に伴うセッションストレージを制限します。デフォルトは 次のとおりです: 
{
  session: {
    maintenance: {
      mode: "enforce", // "enforce" applies cleanup; "warn" only reports
      pruneAfter: "30d",
      maxEntries: 500,
    },
  },
}
本番規模の maxEntries 制限では、Gateway ランタイムの書き込みは小さな 高水位バッファを使い、設定された上限までバッチでクリーンアップします。 セッションストアの読み取りは Gateway 起動時にエントリを prune したり上限を適用したりしないため、 起動や分離された Cron セッションがストア全体のクリーンアップコストを払うことはありません。 openclaw sessions cleanup --enforce は上限を即座に適用します。 Gateway モデル実行プローブセッションは、デフォルトで短命です。 agent:*:explicit:model-run-<uuid> に一致する行は固定の 24h 保持を使用しますが、クリーンアップは 圧力で制御されます。つまり、セッションエントリのメンテナンス/上限制約に達した場合にのみ古いプローブ行を削除し、 より広い古いエントリの経過時間カットオフとエントリ上限の前に実行されます。通常の direct、group、thread、Cron、hook、Heartbeat、 ACP、サブエージェントセッションは、この 24h 保持を継承しません。 メンテナンスは、グループセッションやスレッドスコープのチャットセッションを含む永続的な外部会話ポインターを保持しつつ、 合成された Cron、hook、Heartbeat、ACP、サブエージェントのエントリが経過時間により削除されることも許可します。 以前に DM 分離を使用し、その後 session.dmScope を main に戻した場合は、 openclaw sessions cleanup --dry-run --fix-dm-scope で古いピアキー付き DM 行をプレビューします。同じフラグを適用すると、 それらの古い direct-DM 行は廃止され、トランスクリプトは削除済み アーカイブとして保持されます。 任意のメンテナンス実行は openclaw sessions cleanup --dry-run でプレビューできます。

​
セッションの確認

コマンド表示内容
openclaw statusセッションストアのパスと最近のアクティビティ
openclaw sessions --jsonすべてのセッション (--active <minutes> でフィルター)
チャット内の /statusコンテキスト使用量、モデル、トグル
/context listシステムプロンプトに含まれる内容

​
関連資料

​
関連