Контекстний рушій

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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

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

openclaw plugins install @martian-engineering/lossless-claw

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)
      },
    },
  },
}

​

Як це працює

​

Життєвий цикл субагента (необов’язково)

​

Додавання до system prompt

​

Механізм legacy

• Приймання: no-op (менеджер сесій безпосередньо обробляє збереження повідомлень).
• Збирання: наскрізна передача (наявний конвеєр sanitize → validate → limit у runtime обробляє збирання контексту).
• Compact: делегує вбудованій summarization compaction, яка створює один підсумок давніших повідомлень і залишає останні повідомлення без змін.
• Після ходу: no-op.

​

Механізми Plugin

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

export default function register(api) {
  api.registerContextEngine("my-engine", (ctx) => ({
    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

​

ownsCompaction

​

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

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

​

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

​

Поради

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

​

Пов’язане

• Compaction - узагальнення довгих розмов
• Контекст - як контекст будується для ходів агента
• Архітектура Plugin - реєстрація плагінів рушіїв контексту
• Маніфест Plugin - поля маніфесту плагіна
• Плагіни - огляд плагінів