​

Kontext-Engine

​

Schnellstart

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

​

Installieren eines Kontext-Engine-Plugins

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

​

Funktionsweise

1. Ingest — wird aufgerufen, wenn der Sitzung eine neue Nachricht hinzugefügt wird. Die Engine kann die Nachricht in ihrem eigenen Datenspeicher speichern oder indexieren.
2. Assemble — wird vor jedem Modelllauf aufgerufen. Die Engine gibt eine geordnete Menge von Nachrichten zurück (und eine optionale systemPromptAddition), die innerhalb des Token-Budgets bleibt.
3. Compact — wird aufgerufen, wenn das Kontextfenster voll ist oder wenn der Benutzer /compact ausführt. Die Engine fasst älteren Verlauf zusammen, um Speicherplatz freizugeben.
4. After turn — wird aufgerufen, nachdem ein Lauf abgeschlossen ist. Die Engine kann den Status persistieren, eine Hintergrund-Kompaktierung auslösen oder Indizes aktualisieren.

​

Subagent-Lebenszyklus (optional)

• onSubagentEnded — Aufräumen, wenn eine Subagent-Sitzung abgeschlossen wird oder bereinigt wird.

​

Ergänzung des System-Prompts

​

Die Legacy-Engine

• Ingest: no-op (der Sitzungsmanager übernimmt die Nachrichtenpersistenz direkt).
• Assemble: Durchreichen (die bestehende Pipeline sanitize → validate → limit in der Laufzeit übernimmt die Kontextzusammenstellung).
• Compact: delegiert an die integrierte Zusammenfassungs-Kompaktierung, die eine einzelne Zusammenfassung älterer Nachrichten erstellt und aktuelle Nachrichten unverändert beibehält.
• After turn: no-op.

​

Plugin-Engines

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

​

Die ContextEngine-Schnittstelle

• messages — die geordneten Nachrichten, die an das Modell gesendet werden.
• estimatedTokens (erforderlich, number) — die Schätzung der Engine für die Gesamtzahl der Tokens im zusammengestellten Kontext. OpenClaw verwendet dies für Entscheidungen über Kompaktierungsgrenzen und für Diagnoseberichte.
• systemPromptAddition (optional, string) — wird dem System-Prompt vorangestellt.

​

ownsCompaction

• true — die Engine besitzt das Kompaktierungsverhalten. OpenClaw deaktiviert Pis integrierte automatische Kompaktierung für diesen Lauf, und die Implementierung compact() der Engine ist verantwortlich für /compact, Kompaktierung zur Overflow-Wiederherstellung und jede proaktive Kompaktierung, die sie in afterTurn() ausführen möchte.
• false oder nicht gesetzt — Pis integrierte automatische Kompaktierung kann während der Prompt- Ausführung weiterhin laufen, aber die Methode compact() der aktiven Engine wird weiterhin für /compact und Overflow-Wiederherstellung aufgerufen.

• Owning-Modus — implementieren Sie Ihren eigenen Kompaktierungsalgorithmus und setzen Sie ownsCompaction: true.
• Delegating-Modus — setzen Sie ownsCompaction: false und lassen Sie compact() delegateCompactionToRuntime(...) aus openclaw/plugin-sdk/core aufrufen, um das integrierte Kompaktierungsverhalten von OpenClaw zu verwenden.

​

Konfigurationsreferenz

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

​

Beziehung zu Kompaktierung und Memory

• Kompaktierung ist eine Verantwortung der Kontext-Engine. Die Legacy-Engine delegiert an die integrierte Zusammenfassung von OpenClaw. Plugin-Engines können jede beliebige Kompaktierungsstrategie implementieren (DAG-Zusammenfassungen, Vektorretrieval usw.).
• Memory-Plugins (plugins.slots.memory) sind von Kontext-Engines getrennt. Memory-Plugins stellen Suche/Retrieval bereit; Kontext-Engines steuern, was das Modell sieht. Sie können zusammenarbeiten — eine Kontext-Engine könnte Memory- Plugin-Daten während der Zusammenstellung verwenden. Plugin-Engines, die den aktiven Memory- Prompt-Pfad verwenden möchten, sollten buildMemorySystemPromptAddition(...) aus openclaw/plugin-sdk/core bevorzugen; dies wandelt die aktiven Memory-Prompt-Abschnitte in eine sofort voranstellbare systemPromptAddition um. Wenn eine Engine eine Steuerung auf niedrigerer Ebene benötigt, kann sie weiterhin rohe Zeilen aus openclaw/plugin-sdk/memory-host-core über buildActiveMemoryPromptSection(...) abrufen.
• Session-Pruning (das Kürzen alter Tool-Ergebnisse im Arbeitsspeicher) läuft weiterhin, unabhängig davon, welche Kontext-Engine aktiv ist.

​

Tipps

• Verwenden Sie openclaw doctor, um zu prüfen, ob Ihre Engine korrekt geladen wird.
• Wenn Sie Engines wechseln, werden bestehende Sitzungen mit ihrem aktuellen Verlauf fortgeführt. Die neue Engine übernimmt für zukünftige Läufe.
• Engine-Fehler werden protokolliert und in Diagnosen angezeigt. Wenn sich eine Plugin-Engine nicht registrieren lässt oder die ausgewählte Engine-ID nicht aufgelöst werden kann, fällt OpenClaw nicht automatisch zurück; Läufe schlagen fehl, bis Sie das Plugin reparieren oder plugins.slots.contextEngine wieder auf "legacy" setzen.
• Für die Entwicklung verwenden Sie openclaw plugins install -l ./my-engine, um ein lokales Plugin-Verzeichnis zu verknüpfen, ohne es zu kopieren.

​

Verwandt

• Kontext — wie Kontext für Agent-Turns erstellt wird
• Plugin-Architektur — Registrieren von Kontext-Engine-Plugins
• Kompaktierung — Zusammenfassen langer Konversationen