Контекстный движок

​

Быстрый старт

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,
        // Здесь указывается конфигурация плагина (см. документацию плагина)
      },
    },
  },
}

​

Принцип работы

​

Жизненный цикл субагента (необязательно)

​

Дополнение системного запроса

​

Устаревший движок

• Приём: бездействие (диспетчер сеансов напрямую управляет сохранением сообщений).
• Сборка: сквозная передача (существующий в среде выполнения конвейер очистки → проверки → ограничения управляет сборкой контекста).
• Compaction: делегирует встроенному механизму суммирующей Compaction, который создаёт единую сводку более ранних сообщений и сохраняет последние сообщения без изменений.
• После хода: бездействие.

​

Движки-плагины

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

​

Связь с Compaction и памятью

​

Советы

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

​

Связанные материалы

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