Silnik kontekstu

​

Szybki start

openclaw doctor
# lub sprawdź konfigurację bezpośrednio:
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", // musi odpowiadać identyfikatorowi silnika zarejestrowanemu przez Plugin
    },
    entries: {
      "lossless-claw": {
        enabled: true,
        // Tutaj znajduje się konfiguracja właściwa dla Pluginu (zobacz dokumentację Pluginu)
      },
    },
  },
}

​

Sposób działania

​

Cykl życia podagenta (opcjonalnie)

​

Dodatek do promptu systemowego

​

Starszy silnik

• Pobieranie: brak operacji (menedżer sesji bezpośrednio obsługuje utrwalanie wiadomości).
• Składanie: przekazywanie bez zmian (istniejący potok oczyszczania → walidacji → ograniczania w środowisku uruchomieniowym obsługuje składanie kontekstu).
• Compaction: deleguje do wbudowanego mechanizmu podsumowującego Compaction, który tworzy pojedyncze podsumowanie starszych wiadomości i zachowuje ostatnie wiadomości bez zmian.
• Po turze: brak operacji.

​

Silniki Pluginów

import { buildMemorySystemPromptAddition } from "openclaw/plugin-sdk/core";
import { resolveSessionAgentId } from "openclaw/plugin-sdk/memory-host-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 }) {
      // Zapisz wiadomość w magazynie danych
      return { ingested: true };
    },

    async assemble({
      sessionId,
      sessionKey,
      messages,
      tokenBudget,
      availableTools,
      citationsMode,
    }) {
      // Zwróć wiadomości mieszczące się w budżecie
      return {
        messages: buildContext(messages, tokenBudget),
        estimatedTokens: countTokens(messages),
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
          agentId: resolveSessionAgentId({ config: ctx.config, sessionKey }),
          agentSessionKey: sessionKey,
        }),
      };
    },

    async compact({ sessionId, force }) {
      // Podsumuj starszy kontekst
      return { ok: true, compacted: true };
    },
  }));
}

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

​

Interfejs ContextEngine

​

Ustawienia środowiska uruchomieniowego

• schemaVersion: obecnie 1
• runtime: host OpenClaw, tryb środowiska uruchomieniowego (normal, fallback lub degraded) oraz opcjonalne identyfikatory uprzęży testowej/środowiska uruchomieniowego
• contextEngineSelection: identyfikator wybranego silnika kontekstu i źródło wyboru
• executionHost: identyfikator i etykieta hosta dla 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, jeśli są znane
• diagnostics: zamknięty mechanizm awaryjny i kody przyczyn obniżonego poziomu działania, jeśli są znane

​

Wymagania hosta

info: {
  id: "my-context-engine",
  name: "My Context Engine",
  hostRequirements: {
    "agent-run": {
      requiredCapabilities: ["assemble-before-prompt"],
      unsupportedMessage:
        "Użyj natywnego środowiska uruchomieniowego Codex lub wbudowanego środowiska uruchomieniowego OpenClaw albo wybierz starszy silnik kontekstu.",
    },
  },
}

​

Izolowanie awarii

​

ownsCompaction

​

Dokumentacja konfiguracji

{
  plugins: {
    slots: {
      // Wybierz aktywny silnik kontekstu. Domyślnie: "legacy".
      // Ustaw identyfikator Pluginu, aby użyć silnika Pluginu.
      contextEngine: "legacy",
    },
  },
}

​

Związek z kompaktacją i pamięcią

​

Wskazówki

• Użyj openclaw doctor, aby sprawdzić, czy silnik ładuje się prawidłowo.
• Po przełączeniu silników istniejące sesje zachowują swoją bieżącą historię. Nowy silnik przejmuje obsługę przyszłych uruchomień.
• Błędy silnika są rejestrowane, a wybrany silnik Pluginu zostaje poddany kwarantannie na czas bieżącego procesu Gateway. OpenClaw przełącza się na legacy podczas tur użytkownika, aby odpowiedzi mogły być kontynuowane, ale nadal należy naprawić, zaktualizować, wyłączyć lub odinstalować wadliwy Plugin.
• Do 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 — sposób budowania kontekstu dla tur agenta
• Architektura Pluginów — rejestrowanie Pluginów silnika kontekstu
• Manifest Pluginu — pola manifestu Pluginu
• Pluginy — przegląd Pluginów