​

Механізм контексту

​

Швидкий старт

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 — очищення після завершення сесії субагента або її прибирання.

​

Додавання до системного промпту

​

Механізм legacy

• 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 і відновлення після переповнення.

• Режим керування — реалізуйте власний алгоритм компактування й встановіть ownsCompaction: true.
• Режим делегування — встановіть ownsCompaction: false і зробіть так, щоб compact() викликав delegateCompactionToRuntime(...) з openclaw/plugin-sdk/core, щоб використовувати вбудовану поведінку компактування OpenClaw.

​

Довідка з конфігурації

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

​

Зв’язок із компактуванням і пам’яттю

• Compaction — це одна з відповідальностей механізму контексту. Механізм legacy делегує вбудованому підсумовуванню OpenClaw. Механізми на основі плагінів можуть реалізовувати будь-яку стратегію компактування (DAG-резюме, vector retrieval тощо).
• Плагіни пам’яті (plugins.slots.memory) відокремлені від механізмів контексту. Плагіни пам’яті забезпечують пошук/retrieval; механізми контексту контролюють, що бачить модель. Вони можуть працювати разом — механізм контексту може використовувати дані плагіна пам’яті під час збирання. Механізмам на основі плагінів, яким потрібен активний шлях промпту пам’яті, слід віддавати перевагу buildMemorySystemPromptAddition(...) з openclaw/plugin-sdk/core, який перетворює активні секції промпту пам’яті на готовий до додавання на початок systemPromptAddition. Якщо механізму потрібен контроль нижчого рівня, він усе одно може отримувати сирі рядки з openclaw/plugin-sdk/memory-host-core через buildActiveMemoryPromptSection(...).
• Обрізання сесії (скорочення старих результатів інструментів у пам’яті) усе ще виконується незалежно від того, який механізм контексту активний.

​

Поради

• Використовуйте openclaw doctor, щоб перевірити, чи ваш механізм завантажується правильно.
• Якщо ви перемикаєте механізми, наявні сесії продовжують працювати з поточною історією. Новий механізм перебирає роботу на себе для майбутніх запусків.
• Помилки механізму журналюються й відображаються в діагностиці. Якщо механізм плагіна не вдається зареєструвати або не вдається визначити вибраний ідентифікатор механізму, OpenClaw не виконує автоматичний перехід; запуски завершуються з помилкою, доки ви не виправите плагін або не перемкнете plugins.slots.contextEngine назад на "legacy".
• Для розробки використовуйте openclaw plugins install -l ./my-engine, щоб підключити локальний каталог плагіна без копіювання.

​

Пов’язане

• Контекст — як будується контекст для ходів агента
• Архітектура плагінів — реєстрація плагінів механізму контексту
• Компактування — підсумовування довгих розмов