​

コンテキストエンジン

​

クイックスタート

openclaw doctor
# or inspect config directly:
cat ~/.openclaw/openclaw.json | jq '.plugins.slots.contextEngine'

​

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

# Install from npm
openclaw plugins install @martian-engineering/lossless-claw

# Or install from a local path (for development)
openclaw plugins install -l ./my-context-engine

// openclaw.json
{
  plugins: {
    slots: {
      contextEngine: "lossless-claw", // must match the plugin's registered engine id
    },
    entries: {
      "lossless-claw": {
        enabled: true,
        // Plugin-specific config goes here (see the plugin's docs)
      },
    },
  },
}

​

仕組み

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

​

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

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

​

システムプロンプト追加

​

レガシーエンジン

• Ingest: no-op（セッションマネージャーがメッセージ永続化を直接処理します）。
• Assemble: pass-through（ランタイム内の既存の sanitize → validate → limit パイプラインが コンテキスト組み立てを処理します）。
• Compact: 組み込みの要約圧縮に委譲されます。これは 古いメッセージの単一の要約を作成し、最近のメッセージはそのまま保持します。
• After turn: no-op。

​

プラグインエンジン

import { buildMemorySystemPromptAddition } from "openclaw/plugin-sdk/core";

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

    async ingest({ sessionId, message, isHeartbeat }) {
      // Store the message in your data store
      return { ingested: true };
    },

    async assemble({ sessionId, messages, tokenBudget, availableTools, citationsMode }) {
      // Return messages that fit the budget
      return {
        messages: buildContext(messages, tokenBudget),
        estimatedTokens: countTokens(messages),
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
        }),
      };
    },

    async compact({ sessionId, force }) {
      // Summarize older context
      return { ok: true, compacted: true };
    },
  }));
}

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

​

ContextEngine インターフェース

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

​

ownsCompaction

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

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

​

設定リファレンス

{
  plugins: {
    slots: {
      // Select the active context engine. Default: "legacy".
      // Set to a plugin id to use a plugin engine.
      contextEngine: "legacy",
    },
  },
}

​

圧縮とメモリとの関係

• 圧縮 は、コンテキストエンジンの責務の 1 つです。レガシーエンジンは OpenClaw の組み込み要約に委譲します。プラグインエンジンは 任意の圧縮戦略（DAG 要約、ベクトル検索など）を実装できます。
• メモリプラグイン（plugins.slots.memory）は、コンテキストエンジンとは別です。 メモリプラグインは検索・取得を提供し、コンテキストエンジンは モデルが何を見るかを制御します。両者は連携できます — コンテキストエンジンは 組み立て中にメモリプラグインのデータを使う場合があります。アクティブなメモリ プロンプトパスを使いたいプラグインエンジンは、openclaw/plugin-sdk/core の buildMemorySystemPromptAddition(...) を優先して使うべきです。これはアクティブなメモリプロンプトセクションを そのまま先頭追加できる systemPromptAddition に変換します。エンジンがより低レベルの 制御を必要とする場合は、 openclaw/plugin-sdk/memory-host-core の buildActiveMemoryPromptSection(...) を通じて生の行を取得することもできます。
• セッションの剪定（古いツール結果をメモリ内でトリミングすること）は、 どのコンテキストエンジンがアクティブであっても引き続き実行されます。

​

ヒント

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

​

関連

• コンテキスト — エージェントのターン向けにコンテキストがどのように構築されるか
• プラグインアーキテクチャ — コンテキストエンジンプラグインの登録
• 圧縮 — 長い会話の要約