​

Context Engine

​

Szybki start

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

​

Instalowanie pluginu silnika kontekstu

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

​

Jak to działa

1. Ingest — wywoływany, gdy do sesji zostaje dodana nowa wiadomość. Silnik może przechowywać lub indeksować wiadomość we własnym magazynie danych.
2. Assemble — wywoływany 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ływany, gdy okno kontekstu jest pełne lub gdy użytkownik uruchomi /compact. Silnik podsumowuje starszą historię, aby zwolnić miejsce.
4. After turn — wywoływany po zakończeniu uruchomienia. Silnik może utrwalać stan, uruchamiać kompaktowanie w tle lub aktualizować indeksy.

​

Cykl życia subagenta (opcjonalnie)

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

​

Dodatkowy prompt systemowy

​

Silnik legacy

• Ingest: brak działania (menedżer sesji bezpośrednio obsługuje utrwalanie wiadomości).
• Assemble: przekazanie dalej bez zmian (istniejący potok 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 ostatnie wiadomości bez zmian.
• After turn: brak działania.

​

Silniki pluginów

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

​

Interfejs ContextEngine

• messages — uporządkowane wiadomości do wysłania do modelu.
• estimatedTokens (wymagane, number) — oszacowanie silnika dotyczące łącznej liczby tokenów w złożonym kontekście. OpenClaw używa tego do podejmowania decyzji o progu kompaktowania oraz do raportowania diagnostycznego.
• systemPromptAddition (opcjonalne, string) — dodawane na początku promptu systemowego.

​

ownsCompaction

• true — silnik obsługuje zachowanie kompaktowania. OpenClaw wyłącza wbudowane automatyczne kompaktowanie Pi dla tego uruchomienia, a implementacja compact() danego silnika odpowiada za /compact, kompaktowanie przy odzyskiwaniu po przepełnieniu oraz wszelkie proaktywne kompaktowanie, które ma być wykonywane w afterTurn().
• false lub brak ustawienia — wbudowane automatyczne kompaktowanie Pi nadal może działać podczas wykonywania promptu, ale metoda compact() aktywnego silnika nadal jest wywoływana dla /compact i odzyskiwania po przepełnieniu.

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

​

Dokumentacja konfiguracji

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

​

Relacja do kompaktowania i pamięci

• Kompaktowanie to jedna z odpowiedzialności silnika kontekstu. Silnik legacy deleguje do wbudowanego podsumowywania OpenClaw. Silniki pluginów mogą implementować dowolną strategię kompaktowania (podsumowania DAG, wyszukiwanie wektorowe itd.).
• Pluginy pamięci (plugins.slots.memory) są oddzielne od silników kontekstu. Pluginy pamięci dostarczają wyszukiwanie/odtwarzanie; silniki kontekstu kontrolują to, co widzi model. Mogą współpracować — silnik kontekstu może używać danych pluginu pamięci podczas składania. Silniki pluginów, które chcą używać aktywnej ścieżki promptu pamięci, powinny preferować buildMemorySystemPromptAddition(...) z openclaw/plugin-sdk/core, które konwertuje aktywne sekcje promptu pamięci na gotowe do dodania na początku systemPromptAddition. Jeśli silnik potrzebuje kontroli na niższym poziomie, nadal może pobierać surowe linie z openclaw/plugin-sdk/memory-host-core za pomocą buildActiveMemoryPromptSection(...).
• Przycinanie sesji (usuwanie starych wyników narzędzi z pamięci) nadal działa niezależnie od tego, który silnik kontekstu jest aktywny.

​

Wskazówki

• Użyj openclaw doctor, aby sprawdzić, czy silnik ładuje się poprawnie.
• Jeśli przełączasz silniki, istniejące sesje zachowują swoją obecną historię. Nowy silnik przejmuje obsługę przyszłych uruchomień.
• Błędy silnika są rejestrowane w logach i widoczne w diagnostyce. Jeśli silnik pluginu nie zarejestruje się lub nie można rozwiązać wybranego identyfikatora silnika, OpenClaw nie przełącza się automatycznie z powrotem; uruchomienia będą kończyć się niepowodzeniem, dopóki nie naprawisz pluginu lub nie przełączysz plugins.slots.contextEngine z powrotem na "legacy".
• Do celów programistycznych użyj openclaw plugins install -l ./my-engine, aby podłączyć lokalny katalog pluginu bez kopiowania.

​

Powiązane

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