Silnik kontekstu

​

Szybki start

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

​

Jak to działa

​

Cykl życia subagenta (opcjonalnie)

​

Dodatek do promptu systemowego

​

Silnik legacy

• Ingest: brak operacji (menedżer sesji bezpośrednio obsługuje utrwalanie wiadomości).
• Assemble: przekazanie bez zmian (istniejący pipeline oczyszczania → walidacji → limitowania w runtime obsługuje składanie kontekstu).
• Compact: deleguje do wbudowanej podsumowującej Compaction, która tworzy pojedyncze podsumowanie starszych wiadomości i pozostawia najnowsze wiadomości bez zmian.
• After turn: brak operacji.

​

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

​

Interfejs ContextEngine

​

Ustawienia runtime

• schemaVersion: obecnie 1
• runtime: host OpenClaw, tryb runtime (normal, fallback albo degraded) oraz opcjonalne identyfikatory harnessu/runtime
• contextEngineSelection: identyfikator wybranego silnika kontekstu i źródło wyboru
• executionHost: identyfikator hosta i etykieta powierzchni wywołującej hook
• model: żądany model, rozwiązany model, dostawca i opcjonalna rodzina modelu
• limits: budżet tokenów promptu i maksymalna liczba tokenów wyjściowych, gdy znane
• diagnostics: zamknięte kody powodów fallback i degradacji, gdy znane

​

Wymagania hosta

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

​

Izolacja awarii

​

ownsCompaction

​

Odniesienie konfiguracji

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

​

Relacja do kompakcji i pamięci

​

Wskazówki

• Użyj openclaw doctor, aby sprawdzić, czy silnik ładuje się poprawnie.
• Jeśli przełączasz silniki, istniejące sesje kontynuują pracę ze swoją bieżącą historią. Nowy silnik przejmuje przyszłe przebiegi.
• Błędy silnika są logowane, a wybrany silnik pluginu jest poddawany kwarantannie dla bieżącego procesu Gateway. OpenClaw wraca do legacy dla tur użytkownika, aby odpowiedzi mogły być kontynuowane, ale nadal należy naprawić, zaktualizować, wyłączyć lub odinstalować uszkodzony plugin.
• Podczas programowania użyj openclaw plugins install -l ./my-engine, aby połączyć lokalny katalog pluginu bez kopiowania.

​

Powiązane

• Compaction - podsumowywanie długich rozmów
• Kontekst - jak kontekst jest budowany dla tur agenta
• Architektura pluginów - rejestrowanie pluginów silnika kontekstu
• Manifest pluginu - pola manifestu pluginu
• Pluginy - przegląd pluginów