​

Context Engine

​

Schnellstart

openclaw doctor
# oder Konfiguration direkt prüfen:
cat ~/.openclaw/openclaw.json | jq '.plugins.slots.contextEngine'

​

Installation eines Context-Engine-Plugins

# Von npm installieren
openclaw plugins install @martian-engineering/lossless-claw

# Oder aus einem lokalen Pfad installieren (für Entwicklung)
openclaw plugins install -l ./my-context-engine

// openclaw.json
{
  plugins: {
    slots: {
      contextEngine: "lossless-claw", // muss mit der registrierten Engine-ID des Plugins übereinstimmen
    },
    entries: {
      "lossless-claw": {
        enabled: true,
        // Pluginspezifische Konfiguration kommt hierhin (siehe Plugin-Dokumentation)
      },
    },
  },
}

​

So funktioniert es

1. Ingest — wird aufgerufen, wenn eine neue Nachricht zur Sitzung hinzugefügt wird. Die Engine kann die Nachricht in ihrem eigenen Datenspeicher speichern oder indizieren.
2. Assemble — wird vor jeder Modellausführung aufgerufen. Die Engine gibt eine geordnete Menge von Nachrichten zurück (und optional ein systemPromptAddition), die innerhalb des Token-Budgets liegen.
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 eine Ausführung abgeschlossen ist. Die Engine kann Status speichern, Hintergrundkompaktierung 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 direkt die Persistierung der Nachrichten).
• Assemble: Durchleitung (die vorhandene 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 intakt hält.
• After turn: no-op.

​

Plugin-Engines

export default function register(api) {
  api.registerContextEngine("my-engine", () => ({
    info: {
      id: "my-engine",
      name: "My Context Engine",
      ownsCompaction: true,
    },

    async ingest({ sessionId, message, isHeartbeat }) {
      // Nachricht in Ihrem Datenspeicher speichern
      return { ingested: true };
    },

    async assemble({ sessionId, messages, tokenBudget }) {
      // Nachrichten zurückgeben, die in das Budget passen
      return {
        messages: buildContext(messages, tokenBudget),
        estimatedTokens: countTokens(messages),
        systemPromptAddition: "Use lcm_grep to search history...",
      };
    },

    async compact({ sessionId, force }) {
      // Älteren Kontext zusammenfassen
      return { ok: true, compacted: true };
    },
  }));
}

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

​

Die Schnittstelle ContextEngine

• 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 Kompaktierungsschwellen und für Diagnoseberichte.
• systemPromptAddition (optional, string) — wird dem System-Prompt vorangestellt.

​

ownsCompaction

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

• Besitzender Modus — implementieren Sie Ihren eigenen Kompaktierungsalgorithmus und setzen Sie ownsCompaction: true.
• Delegierender 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: {
      // Die aktive Context Engine auswählen. Standard: "legacy".
      // Auf eine Plugin-ID setzen, um eine Plugin-Engine zu verwenden.
      contextEngine: "legacy",
    },
  },
}

​

Beziehung zu Kompaktierung und Speicher

• Kompaktierung ist eine Aufgabe der Context Engine. Die Legacy-Engine delegiert an die integrierte Zusammenfassung von OpenClaw. Plugin-Engines können beliebige Kompaktierungsstrategien implementieren (DAG-Zusammenfassungen, Vektor-Retrieval usw.).
• Memory-Plugins (plugins.slots.memory) sind von Context Engines getrennt. Memory-Plugins stellen Suche/Retrieval bereit; Context Engines steuern, was das Modell sieht. Sie können zusammenarbeiten — eine Context Engine könnte Daten aus einem Memory-Plugin während der Zusammenstellung verwenden.
• Sitzungsbereinigung (Trimmen alter Tool-Ergebnisse im Speicher) läuft weiterhin, unabhängig davon, welche Context Engine aktiv ist.

​

Tipps

• Verwenden Sie openclaw doctor, um zu prüfen, ob Ihre Engine korrekt geladen wird.
• Wenn Sie Engines wechseln, laufen vorhandene Sitzungen mit ihrem aktuellen Verlauf weiter. Die neue Engine übernimmt zukünftige Ausführungen.
• Engine-Fehler werden protokolliert und in der Diagnose angezeigt. Wenn eine Plugin-Engine sich nicht registrieren lässt oder die ausgewählte Engine-ID nicht aufgelöst werden kann, fällt OpenClaw nicht automatisch zurück; Ausführungen 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

• Context — wie Kontext für Agent-Turns aufgebaut wird
• Plugin Architecture — Registrierung von Context-Engine-Plugins
• Compaction — Zusammenfassen langer Unterhaltungen