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

​

Швидкий початок

openclaw doctor
# або перевірте конфігурацію безпосередньо:
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", // має відповідати ідентифікатору рушія, зареєстрованому плагіном
    },
    entries: {
      "lossless-claw": {
        enabled: true,
        // Тут указується конфігурація плагіна (див. документацію плагіна)
      },
    },
  },
}

​

Як це працює

​

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

​

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

​

Застарілий рушій

• Приймання: не виконує жодних дій (диспетчер сеансів безпосередньо керує збереженням повідомлень).
• Формування: передає дані без змін (формуванням контексту керує наявний у середовищі виконання конвеєр очищення → перевірки → обмеження).
• Ущільнення: делегує роботу вбудованому ущільненню шляхом узагальнення, яке створює єдине резюме давніших повідомлень і залишає останні повідомлення без змін.
• Після ходу: не виконує жодних дій.

​

Рушії-плагіни

import { buildMemorySystemPromptAddition } from "openclaw/plugin-sdk/core";
import { resolveSessionAgentId } from "openclaw/plugin-sdk/memory-host-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 }) {
      // Збережіть повідомлення у своєму сховищі даних
      return { ingested: true };
    },

    async assemble({
      sessionId,
      sessionKey,
      messages,
      tokenBudget,
      availableTools,
      citationsMode,
    }) {
      // Поверніть повідомлення, які вкладаються в бюджет
      return {
        messages: buildContext(messages, tokenBudget),
        estimatedTokens: countTokens(messages),
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
          agentId: resolveSessionAgentId({ config: ctx.config, sessionKey }),
          agentSessionKey: sessionKey,
        }),
      };
    },

    async compact({ sessionId, force }) {
      // Узагальніть давніший контекст
      return { ok: true, compacted: true };
    },
  }));
}

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

​

Інтерфейс ContextEngine

​

Налаштування середовища виконання

• schemaVersion: наразі 1
• runtime: хост OpenClaw, режим середовища виконання (normal, fallback або degraded) та необов’язкові ідентифікатори тестового каркаса/середовища виконання
• contextEngineSelection: ідентифікатор вибраного рушія контексту та джерело вибору
• executionHost: ідентифікатор і мітка хоста для поверхні, що викликає хук
• model: запитана модель, визначена модель, провайдер і необов’язкове сімейство моделей
• limits: бюджет токенів запиту та максимальна кількість вихідних токенів, якщо відомо
• diagnostics: коди причин закритого резервного переходу та роботи в погіршеному режимі, якщо відомо

​

Вимоги до хоста

info: {
  id: "my-context-engine",
  name: "My Context Engine",
  hostRequirements: {
    "agent-run": {
      requiredCapabilities: ["assemble-before-prompt"],
      unsupportedMessage:
        "Використовуйте вбудоване середовище виконання Codex або OpenClaw чи виберіть застарілий рушій контексту.",
    },
  },
}

​

Ізоляція збоїв

​

ownsCompaction

​

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

{
  plugins: {
    slots: {
      // Виберіть активний рушій контексту. Типове значення: "legacy".
      // Установіть ідентифікатор плагіна, щоб використовувати рушій плагіна.
      contextEngine: "legacy",
    },
  },
}

​

Зв’язок з ущільненням і пам’яттю

​

Поради

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

​

Пов’язані матеріали

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