コンパクション

すべてのモデルにはコンテキストウィンドウがあります。これは、処理できるトークン数の上限です。会話がその上限に近づくと、OpenClawは古いメッセージを要約してコンパクト化し、チャットを継続できるようにします。

仕組み

古い会話ターンはコンパクトなエントリに要約されます。
要約はセッショントランスクリプトに保存されます。
最近のメッセージはそのまま保持されます。

OpenClawが履歴をコンパクションチャンクに分割するとき、assistantのツール呼び出しは対応する toolResult エントリと組み合わせたまま保持されます。分割点がツールブロックの途中に来る場合、OpenClawはそのペアが一緒に保たれ、現在の未要約の末尾が維持されるように境界を移動します。会話履歴全体はディスク上に残ります。コンパクションで変わるのは、次のターンでモデルが見る内容だけです。

自動コンパクション

自動コンパクションはデフォルトでオンです。セッションがコンテキスト制限に近づくと実行されるか、モデルがコンテキスト超過エラーを返したときに実行されます（この場合、 OpenClawはコンパクト化して再試行します）。一般的な超過シグネチャには request_too_large、context length exceeded、input exceeds the maximum number of tokens、input token count exceeds the maximum number of input tokens、input is too long for the model、ollama error: context length exceeded があります。

コンパクト化の前に、OpenClawは重要なメモを memory ファイルに保存するようエージェントに自動で通知します。これにより、コンテキストの喪失を防ぎます。

openclaw.json の agents.defaults.compaction 設定を使用して、コンパクションの動作（モード、目標トークン数など）を設定します。コンパクション要約では、デフォルトで不透明な識別子が保持されます（identifierPolicy: "strict"）。これは identifierPolicy: "off" で上書きするか、identifierPolicy: "custom" と identifierInstructions を使ってカスタムテキストを指定できます。必要に応じて、agents.defaults.compaction.model でコンパクション要約用に別のモデルを指定することもできます。これは、プライマリモデルがローカルモデルまたは小規模モデルで、より高性能なモデルにコンパクション要約を生成させたい場合に便利です。この上書きは任意の provider/model-id 文字列を受け付けます。

{
  "agents": {
    "defaults": {
      "compaction": {
        "model": "openrouter/anthropic/claude-sonnet-4-6"
      }
    }
  }
}

これはローカルモデルでも機能します。たとえば、要約専用の2つ目のOllamaモデルや、コンパクション専用にファインチューニングされたモデルを指定できます。

{
  "agents": {
    "defaults": {
      "compaction": {
        "model": "ollama/llama3.1:8b"
      }
    }
  }
}

未設定の場合、コンパクションはエージェントのプライマリモデルを使用します。

プラガブルなコンパクションプロバイダー

プラグインは、プラグインAPIの registerCompactionProvider() を介してカスタムのコンパクションプロバイダーを登録できます。プロバイダーが登録されて設定されている場合、OpenClawは組み込みのLLMパイプラインの代わりにそのプロバイダーへ要約を委譲します。登録済みプロバイダーを使用するには、設定でプロバイダーIDを指定します。

{
  "agents": {
    "defaults": {
      "compaction": {
        "provider": "my-provider"
      }
    }
  }
}

provider を設定すると、自動的に mode: "safeguard" が強制されます。プロバイダーは、組み込み経路と同じコンパクション命令および識別子保持ポリシーを受け取り、OpenClawはプロバイダー出力の後でも最近のターンおよび分割ターンのサフィックスコンテキストを保持します。プロバイダーが失敗するか空の結果を返した場合、OpenClawは組み込みのLLM要約にフォールバックします。

自動コンパクション（デフォルトでオン）

セッションがモデルのコンテキストウィンドウに近づくか、それを超えると、OpenClawは自動コンパクションをトリガーし、コンパクト化されたコンテキストを使って元のリクエストを再試行することがあります。表示される内容:

詳細モードでは 🧹 Auto-compaction complete
/status に 🧹 Compactions: <count> が表示されます

コンパクションの前に、OpenClawはサイレントメモリフラッシュターンを実行して、永続的なメモをディスクに保存できます。詳細と設定については Memory を参照してください。

手動コンパクション

任意のチャットで /compact と入力すると、コンパクションを強制実行できます。要約を誘導するための指示を追加することもできます。

/compact Focus on the API design decisions

別のモデルを使う

デフォルトでは、コンパクションはエージェントのプライマリモデルを使用します。より高性能なモデルを使って、より良い要約を得ることができます。

{
  agents: {
    defaults: {
      compaction: {
        model: "openrouter/anthropic/claude-sonnet-4-6",
      },
    },
  },
}