​

Motor de contexto

​

Inicio rápido

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

​

Instalar un plugin de motor de contexto

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

​

Cómo funciona

1. Ingesta — se llama cuando se añade un mensaje nuevo a la sesión. El motor puede almacenar o indexar el mensaje en su propio almacén de datos.
2. Ensamblaje — se llama antes de cada ejecución del modelo. El motor devuelve un conjunto ordenado de mensajes (y un systemPromptAddition opcional) que caben dentro del presupuesto de tokens.
3. Compactación — se llama cuando la ventana de contexto está llena, o cuando el usuario ejecuta /compact. El motor resume el historial anterior para liberar espacio.
4. Después del turno — se llama después de que se complete una ejecución. El motor puede persistir el estado, activar la compactación en segundo plano o actualizar índices.

​

Ciclo de vida del subagente (opcional)

• onSubagentEnded — limpia cuando una sesión de subagente se completa o se depura.

​

Adición a la indicación del sistema

​

El motor heredado

• Ingesta: sin operación (el administrador de sesiones gestiona directamente la persistencia de mensajes).
• Ensamblaje: paso directo (la canalización existente sanitize → validate → limit del entorno de ejecución se encarga del ensamblaje del contexto).
• Compactación: delega en la compactación de resumen integrada, que crea un único resumen de los mensajes anteriores y mantiene intactos los mensajes recientes.
• Después del turno: sin operación.

​

Motores de plugin

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

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

​

La interfaz ContextEngine

• messages — los mensajes ordenados que se enviarán al modelo.
• estimatedTokens (obligatorio, number) — la estimación del motor del total de tokens en el contexto ensamblado. OpenClaw usa esto para las decisiones sobre el umbral de compactación y para los informes de diagnóstico.
• systemPromptAddition (opcional, string) — se antepone a la indicación del sistema.

​

ownsCompaction

• true — el motor controla el comportamiento de compactación. OpenClaw desactiva la autocompactación integrada de Pi para esa ejecución, y la implementación compact() del motor es responsable de /compact, de la compactación de recuperación por desbordamiento y de cualquier compactación proactiva que quiera hacer en afterTurn().
• false o sin establecer — la autocompactación integrada de Pi todavía puede ejecutarse durante la ejecución de la indicación, pero el método compact() del motor activo sigue llamándose para /compact y la recuperación por desbordamiento.

• Modo propietario — implementa tu propio algoritmo de compactación y establece ownsCompaction: true.
• Modo delegado — establece ownsCompaction: false y haz que compact() llame a delegateCompactionToRuntime(...) desde openclaw/plugin-sdk/core para usar el comportamiento de compactación integrado de OpenClaw.

​

Referencia de configuración

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

​

Relación con la compactación y la memoria

• Compactación es una de las responsabilidades del motor de contexto. El motor heredado delega en el resumen integrado de OpenClaw. Los motores de plugin pueden implementar cualquier estrategia de compactación (resúmenes DAG, recuperación vectorial, etc.).
• Plugins de memoria (plugins.slots.memory) están separados de los motores de contexto. Los plugins de memoria proporcionan búsqueda/recuperación; los motores de contexto controlan lo que el modelo ve. Pueden trabajar juntos: un motor de contexto podría usar datos del plugin de memoria durante el ensamblaje. Los motores de plugin que quieran la ruta activa de indicación de memoria deben preferir buildMemorySystemPromptAddition(...) de openclaw/plugin-sdk/core, que convierte las secciones activas de la indicación de memoria en un systemPromptAddition listo para anteponer. Si un motor necesita un control de nivel inferior, aún puede extraer líneas sin procesar de openclaw/plugin-sdk/memory-host-core mediante buildActiveMemoryPromptSection(...).
• Depuración de sesiones (recorte de resultados antiguos de herramientas en memoria) sigue ejecutándose independientemente de qué motor de contexto esté activo.

​

Consejos

• Usa openclaw doctor para verificar que tu motor se está cargando correctamente.
• Si cambias de motor, las sesiones existentes continúan con su historial actual. El nuevo motor toma el control en las ejecuciones futuras.
• Los errores del motor se registran y se muestran en los diagnósticos. Si un motor de plugin no logra registrarse o no se puede resolver el id de motor seleccionado, OpenClaw no recurre automáticamente a otro; las ejecuciones fallan hasta que corrijas el plugin o cambies plugins.slots.contextEngine de nuevo a "legacy".
• Para desarrollo, usa openclaw plugins install -l ./my-engine para enlazar un directorio de plugin local sin copiarlo.

​

Relacionado

• Contexto — cómo se construye el contexto para los turnos del agente
• Arquitectura de plugins — registrar plugins de motor de contexto
• Compactación — resumir conversaciones largas