Механизм контекста

​

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

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

​

Как это работает

​

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

​

Добавление к системному промпту

​

Движок legacy

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

​

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

​

Настройки runtime

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

​

Требования к хосту

info: {
  id: "my-context-engine",
  name: "My Context Engine",
  hostRequirements: {
    "agent-run": {
      requiredCapabilities: ["assemble-before-prompt"],
      unsupportedMessage:
        "Use the native Codex or OpenClaw embedded runtime, or select the legacy context engine.",
    },
  },
}

​

Изоляция сбоев

​

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 помещается в карантин для текущего процесса Gateway. OpenClaw откатывается к legacy для пользовательских turns, чтобы ответы могли продолжаться, но вам все равно следует исправить, обновить, отключить или удалить неисправный Plugin.
• Для разработки используйте openclaw plugins install -l ./my-engine, чтобы связать локальный каталог Plugin без копирования.

​

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

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