​

Silnik kontekstu

​

Szybki start

openclaw doctor
# lub sprawdź config bezpośrednio:
cat ~/.openclaw/openclaw.json | jq '.plugins.slots.contextEngine'

​

Instalowanie wtyczki silnika kontekstu

# Instalacja z npm
openclaw plugins install @martian-engineering/lossless-claw

# Lub instalacja z lokalnej ścieżki (do programowania)
openclaw plugins install -l ./my-context-engine

// openclaw.json
{
  plugins: {
    slots: {
      contextEngine: "lossless-claw", // musi odpowiadać zarejestrowanemu id silnika wtyczki
    },
    entries: {
      "lossless-claw": {
        enabled: true,
        // Tutaj trafia config specyficzny dla wtyczki (zobacz dokumentację wtyczki)
      },
    },
  },
}

​

Jak to działa

1. Ingest — wywoływane, gdy nowa wiadomość jest dodawana do sesji. Silnik może zapisać lub zindeksować wiadomość we własnym magazynie danych.
2. Assemble — wywoływane przed każdym uruchomieniem modelu. Silnik zwraca uporządkowany zestaw wiadomości (oraz opcjonalne systemPromptAddition), które mieszczą się w budżecie tokenów.
3. Compact — wywoływane, gdy okno kontekstu jest pełne albo gdy użytkownik uruchamia /compact. Silnik podsumowuje starszą historię, aby zwolnić miejsce.
4. After turn — wywoływane po zakończeniu uruchomienia. Silnik może utrwalić stan, uruchomić kompaktowanie w tle albo zaktualizować indeksy.

​

Cykl życia subagenta (opcjonalnie)

• onSubagentEnded — sprzątanie po zakończeniu sesji subagenta albo po jej usunięciu.

​

Dodatek do promptu systemowego

​

Silnik legacy

• Ingest: no-op (menedżer sesji obsługuje utrwalanie wiadomości bezpośrednio).
• Assemble: pass-through (istniejący pipeline sanitize → validate → limit w środowisku uruchomieniowym obsługuje składanie kontekstu).
• Compact: deleguje do wbudowanego kompaktowania przez podsumowanie, które tworzy jedno podsumowanie starszych wiadomości i pozostawia nienaruszone ostatnie wiadomości.
• After turn: no-op.

​

Silniki wtyczek

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 }) {
      // Return messages that fit the budget
      return {
        messages: buildContext(messages, tokenBudget),
        estimatedTokens: countTokens(messages),
        systemPromptAddition: "Use lcm_grep to search history...",
      };
    },

    async compact({ sessionId, force }) {
      // Summarize older context
      return { ok: true, compacted: true };
    },
  }));
}

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

​

Interfejs ContextEngine

• messages — uporządkowane wiadomości do wysłania do modelu.
• estimatedTokens (wymagane, number) — szacowana przez silnik łączna liczba tokenów w złożonym kontekście. OpenClaw używa tego do podejmowania decyzji o progu kompaktowania i do raportowania diagnostycznego.
• systemPromptAddition (opcjonalne, string) — dodawane na początku promptu systemowego.

​

ownsCompaction

• true — silnik zarządza zachowaniem kompaktowania. OpenClaw wyłącza wbudowane w Pi automatyczne kompaktowanie dla tego uruchomienia, a implementacja compact() w silniku odpowiada za /compact, kompaktowanie przy odzyskiwaniu po przepełnieniu oraz każde proaktywne kompaktowanie, które chce wykonać w afterTurn().
• false lub nieustawione — wbudowane automatyczne kompaktowanie Pi może nadal działać podczas wykonywania promptu, ale metoda compact() aktywnego silnika nadal jest wywoływana dla /compact i odzyskiwania po przepełnieniu.

• Tryb przejęcia — zaimplementuj własny algorytm kompaktowania i ustaw ownsCompaction: true.
• Tryb delegowania — ustaw ownsCompaction: false i spraw, aby compact() wywoływało delegateCompactionToRuntime(...) z openclaw/plugin-sdk/core, aby użyć wbudowanego zachowania kompaktowania OpenClaw.

​

Dokumentacja config

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

​

Relacja z kompaktowaniem i pamięcią

• Kompaktowanie jest jedną z odpowiedzialności silnika kontekstu. Silnik legacy deleguje do wbudowanego podsumowywania OpenClaw. Silniki wtyczek mogą implementować dowolną strategię kompaktowania (podsumowania DAG, pobieranie wektorowe itd.).
• Wtyczki pamięci (plugins.slots.memory) są oddzielone od silników kontekstu. Wtyczki pamięci zapewniają wyszukiwanie/pobieranie; silniki kontekstu sterują tym, co model widzi. Mogą działać razem — silnik kontekstu może używać danych z wtyczki pamięci podczas składania.
• Przycinanie sesji (obcinanie starych wyników narzędzi w pamięci) nadal działa niezależnie od tego, który silnik kontekstu jest aktywny.

​

Wskazówki

• Użyj openclaw doctor, aby sprawdzić, czy Twój silnik ładuje się poprawnie.
• Jeśli przełączasz silniki, istniejące sesje nadal działają z obecną historią. Nowy silnik przejmuje obsługę przyszłych uruchomień.
• Błędy silnika są rejestrowane i pokazywane w diagnostyce. Jeśli silnik wtyczki nie zarejestruje się albo nie można rozwiązać wybranego identyfikatora silnika, OpenClaw nie przełącza się automatycznie na tryb zapasowy; uruchomienia kończą się błędem, dopóki nie naprawisz wtyczki albo nie przełączysz plugins.slots.contextEngine z powrotem na "legacy".
• Do programowania używaj openclaw plugins install -l ./my-engine, aby podlinkować lokalny katalog wtyczki bez kopiowania.

​

Powiązane

• Context — jak budowany jest kontekst dla turnów agenta
• Plugin Architecture — rejestrowanie wtyczek silnika kontekstu
• Compaction — podsumowywanie długich rozmów