Sessions and memory

セッションのプルーニング

セッションのプルーニングは、各LLM呼び出しの前にコンテキストから古いツール結果をトリミングします。これにより、通常の会話テキストを書き換えることなく、蓄積したツール出力（exec結果、ファイル読み取り、検索結果）によるコンテキストの肥大化を抑えます。

なぜ重要か

長いセッションでは、コンテキストウィンドウを膨らませるツール出力が蓄積します。これによりコストが増加し、必要以上に早く Compaction が必要になることがあります。

プルーニングは、特にAnthropicのプロンプトキャッシュで効果的です。キャッシュTTLが期限切れになると、次のリクエストで完全なプロンプトが再キャッシュされます。プルーニングはキャッシュ書き込みサイズを減らし、コストを直接下げます。

OpenClawは、履歴内に生の画像ブロックやプロンプトハイドレーション用メディアマーカーが残るセッション向けに、別の冪等なリプレイビューも構築します。

直近3つの完了済みターンはバイト単位でそのまま保持されるため、最近のフォローアップに対するプロンプトキャッシュのプレフィックスは安定したままです。
リプレイビューでは、user または toolResult 履歴にある、すでに処理済みの古い画像ブロックを [image data removed - already processed by model] に置き換えられます。
[media attached: ...]、[Image: source: ...]、media://inbound/... のような古いテキストのメディア参照は、[media reference removed - already processed by model] に置き換えられます。現在ターンの添付マーカーはそのまま維持されるため、visionモデルは新しい画像を引き続きハイドレートできます。
生のセッショントランスクリプトは書き換えられないため、履歴ビューアーでは元のメッセージエントリとその画像を引き続き表示できます。
これは通常のキャッシュTTLプルーニングとは別物です。後続ターンで繰り返し現れる画像ペイロードや古いメディア参照がプロンプトキャッシュを壊すのを防ぐために存在します。

OpenClawはAnthropicプロファイルで自動的にプルーニングを有効にします。

Profile type	プルーニング有効	Heartbeat
Anthropic OAuth/トークン認証（Claude CLI再利用を含む）	はい	1時間
APIキー	はい	30分

明示的な値を設定している場合、OpenClawはそれを上書きしません。

Anthropic以外のプロバイダーでは、プルーニングはデフォルトで無効です。有効にするには:

{
  agents: {
    defaults: {
      contextPruning: { mode: "cache-ttl", ttl: "5m" },
    },
  },
}

無効にするには、mode: "off" を設定します。

両者は相互補完的です。プルーニングは、Compactionサイクルの間、ツール出力を軽量に保ちます。