​

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

​

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

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 — викликається після завершення запуску. Механізм може зберігати стан, запускати фоновий compaction або оновлювати індекси.

​

Життєвий цикл subagent (необов’язково)

• onSubagentEnded — очищення після завершення або прибирання сесії subagent.

​

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

​

Механізм legacy

• Ingest: no-op (менеджер сесій безпосередньо обробляє збереження повідомлень).
• Assemble: наскрізний прохід (наявний конвеєр sanitize → validate → limit у runtime обробляє збирання контексту).
• Compact: делегує вбудованому compaction із підсумовуванням, який створює єдиний підсумок старіших повідомлень і зберігає недавні повідомлення без змін.
• 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 }) {
      // Store the message in your data store
      return { ingested: true };
    },

    async assemble({ sessionId, messages, tokenBudget }) {
      // Return messages that fit the budget
      return {
        messages: buildContext(messages, tokenBudget),
        estimatedTokens: countTokens(messages),
        systemPromptAddition: "Use lcm_grep to search history...",
      };
    },

    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 використовує це для рішень про поріг compaction і для діагностичної звітності.
• systemPromptAddition (необов’язково, string) — додається на початок системного промпта.

​

ownsCompaction

• true — механізм сам керує поведінкою compaction. OpenClaw вимикає вбудований auto-compaction Pi для цього запуску, а реалізація compact() у механізмі відповідає за /compact, compaction для відновлення після переповнення та будь-який проактивний compaction, який механізм хоче виконувати в afterTurn().
• false або не задано — вбудований auto-compaction Pi усе ще може виконуватися під час виконання промпта, але метод compact() активного механізму все одно викликається для /compact і відновлення після переповнення.

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

​

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

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

​

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

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

​

Поради

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

​

Пов’язане

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