​

Context Engine

​

クイックスタート

openclaw doctor
# または config を直接確認:
cat ~/.openclaw/openclaw.json | jq '.plugins.slots.contextEngine'

​

コンテキストエンジンプラグインのインストール

# npm からインストール
openclaw plugins install @martian-engineering/lossless-claw

# またはローカルパスからインストール（開発用）
openclaw plugins install -l ./my-context-engine

// openclaw.json
{
  plugins: {
    slots: {
      contextEngine: "lossless-claw", // プラグインが登録した engine id と一致している必要があります
    },
    entries: {
      "lossless-claw": {
        enabled: true,
        // プラグイン固有の config はここに入ります（プラグインのドキュメントを参照）
      },
    },
  },
}

​

仕組み

1. Ingest — 新しいメッセージがセッションに追加されたときに呼び出されます。エンジンは そのメッセージを独自のデータストアに保存またはインデックス化できます。
2. Assemble — 各モデル実行の前に呼び出されます。エンジンは、トークン予算内に収まる 順序付きのメッセージセット（および任意の systemPromptAddition）を返します。
3. Compact — コンテキストウィンドウがいっぱいになったとき、またはユーザーが /compact を実行したときに呼び出されます。エンジンは古い履歴を要約して空き領域を作ります。
4. After turn — 実行の完了後に呼び出されます。エンジンは状態を永続化したり、 バックグラウンドコンパクションをトリガーしたり、インデックスを更新したりできます。

​

サブエージェントのライフサイクル（任意）

• onSubagentEnded — サブエージェントセッションが完了またはクリーンアップされたときに後始末します。

​

システムプロンプト追加

​

legacy エンジン

• Ingest: no-op（セッションマネージャーがメッセージの永続化を直接処理します）。
• Assemble: パススルー（実行時の既存の sanitize → validate → limit パイプラインが コンテキスト構築を処理します）。
• Compact: 組み込みの要約コンパクションに委譲し、 古いメッセージの単一の要約を作成して最近のメッセージをそのまま保持します。
• After turn: no-op。

​

プラグインエンジン

export default function register(api) {
  api.registerContextEngine("my-engine", () => ({
    info: {
      id: "my-engine",
      name: "My Context Engine",
      ownsCompaction: true,
    },

    async ingest({ sessionId, message, isHeartbeat }) {
      // メッセージをデータストアに保存
      return { ingested: true };
    },

    async assemble({ sessionId, messages, tokenBudget }) {
      // 予算内に収まるメッセージを返す
      return {
        messages: buildContext(messages, tokenBudget),
        estimatedTokens: countTokens(messages),
        systemPromptAddition: "Use lcm_grep to search history...",
      };
    },

    async compact({ sessionId, force }) {
      // 古いコンテキストを要約
      return { ok: true, compacted: true };
    },
  }));
}

{
  plugins: {
    slots: {
      contextEngine: "my-engine",
    },
    entries: {
      "my-engine": {
        enabled: true,
      },
    },
  },
}

​

ContextEngine インターフェース

• messages — モデルに送信する順序付きメッセージ。
• estimatedTokens（必須、number）— 構築されたコンテキスト内の 合計トークン数に対するエンジンの推定値。OpenClaw はこれを compaction のしきい値判断と 診断レポートに使用します。
• systemPromptAddition（任意、string）— システムプロンプトの先頭に追加されます。

​

ownsCompaction

• true — エンジンが compaction 動作を所有します。OpenClaw はその実行に対して Pi の組み込み auto-compaction を無効にし、エンジンの compact() 実装が /compact、オーバーフロー回復 compaction、 および afterTurn() で行いたい任意の先回り compaction を担当します。
• false または未設定 — プロンプト実行中に Pi の組み込み auto-compaction が引き続き実行される場合がありますが、 アクティブなエンジンの compact() メソッドは /compact とオーバーフロー回復のために引き続き呼び出されます。

• Owning mode — 独自の compaction アルゴリズムを実装し、 ownsCompaction: true を設定します。
• Delegating mode — ownsCompaction: false を設定し、compact() から openclaw/plugin-sdk/core の delegateCompactionToRuntime(...) を呼び出して、 OpenClaw の組み込み compaction 動作を使用します。

​

config リファレンス

{
  plugins: {
    slots: {
      // アクティブな context engine を選択します。デフォルト: "legacy"。
      // plugin エンジンを使用するには plugin id に設定します。
      contextEngine: "legacy",
    },
  },
}

​

compaction と memory との関係

• Compaction は context engine の責務の 1 つです。legacy エンジンは OpenClaw の組み込み要約に委譲します。プラグインエンジンは任意の compaction 戦略 （DAG 要約、ベクター検索など）を実装できます。
• Memory plugins（plugins.slots.memory）は context engine とは別物です。 memory plugins は検索 / 取得を提供し、context engine はモデルが何を見るかを制御します。 これらは連携できます。たとえば context engine は構築中に memory plugin のデータを使用する場合があります。
• Session pruning（古いツール結果のインメモリでのトリミング）は、 どの context engine がアクティブであるかに関係なく引き続き実行されます。

​

ヒント

• openclaw doctor を使用して、エンジンが正しく読み込まれていることを確認してください。
• エンジンを切り替えた場合でも、既存のセッションは現在の履歴を維持したまま継続されます。 新しいエンジンは今後の実行に対して引き継ぎます。
• エンジンエラーはログに記録され、診断情報に表示されます。プラグインエンジンの 登録に失敗した場合、または選択した engine id を解決できない場合、OpenClaw は 自動的にはフォールバックしません。plugin を修正するか、 plugins.slots.contextEngine を "legacy" に戻すまで、実行は失敗します。
• 開発時には、openclaw plugins install -l ./my-engine を使用して ローカル plugin ディレクトリをコピーせずにリンクしてください。

​

関連

• Context — エージェントターン用のコンテキストがどのように構築されるか
• Plugin Architecture — context engine plugin の登録
• Compaction — 長い会話の要約