Sitzungsbereinigung

Die Sitzungsbereinigung kürzt alte Tool-Ergebnisse aus dem Kontext vor jedem LLM- Aufruf. Sie reduziert das Anwachsen des Kontexts durch angesammelte Tool-Ausgaben (Exec-Ergebnisse, Datei- Lesevorgänge, Suchergebnisse), ohne normalen Konversationstext umzuschreiben.

# Warum das wichtig ist

Lange Sitzungen sammeln Tool-Ausgaben an, die das Kontextfenster aufblähen. Das erhöht die Kosten und kann Compaction früher als nötig erzwingen.

Die Bereinigung ist besonders wertvoll für das Anthropic-Prompt-Caching. Nach Ablauf der Cache- TTL schreibt die nächste Anfrage den vollständigen Prompt erneut in den Cache. Die Bereinigung reduziert die Größe dieses Cache-Schreibvorgangs und senkt damit direkt die Kosten.

# So funktioniert es

1. Warten, bis die Cache-TTL abläuft (standardmäßig 5 Minuten).
2. Alte Tool-Ergebnisse für die normale Bereinigung finden (Konversationstext bleibt unberührt).
3. Übergroße Ergebnisse weich kürzen -- Anfang und Ende beibehalten, ... einfügen.
4. Den Rest hart leeren -- durch einen Platzhalter ersetzen.
5. Die TTL zurücksetzen, damit Folgeanfragen den frischen Cache wiederverwenden.

# Legacy-Bildbereinigung

OpenClaw erstellt außerdem eine separate idempotente Replay-Ansicht für Sitzungen, die rohe Bildblöcke oder Prompt-Hydration-Medienmarker im Verlauf speichern.

• Dabei bleiben die 3 neuesten abgeschlossenen Turns bytegenau erhalten, damit Prompt- Cache-Präfixe für aktuelle Folgeanfragen stabil bleiben.
• In der Replay-Ansicht können ältere, bereits verarbeitete Bildblöcke aus dem Verlauf von user oder toolResult durch [image data removed - already processed by model] ersetzt werden.
• Ältere textuelle Medienreferenzen wie [media attached: ...], [Image: source: ...] und media://inbound/... können durch [media reference removed - already processed by model] ersetzt werden. Marker für Anhänge im aktuellen Turn bleiben erhalten, damit Vision-Modelle weiterhin frische Bilder hydrieren können.
• Das rohe Sitzungs-Transkript wird nicht umgeschrieben, sodass Verlaufsansichten weiterhin die ursprünglichen Nachrichteneinträge und ihre Bilder rendern können.
• Dies ist getrennt von der normalen Cache-TTL-Bereinigung. Es existiert, um zu verhindern, dass wiederholte Bild-Payloads oder veraltete Medienreferenzen bei späteren Turns Prompt-Caches ungültig machen.

# Intelligente Standardwerte

OpenClaw aktiviert die Bereinigung automatisch für Anthropic-Profile:

Profiltyp	Bereinigung aktiviert	Heartbeat
Anthropic-OAuth-/Token-Auth (einschließlich Wiederverwendung der Claude CLI)	Ja	1 Stunde
API-Schlüssel	Ja	30 min

Wenn Sie explizite Werte setzen, überschreibt OpenClaw diese nicht.

# Aktivieren oder deaktivieren

Für Nicht-Anthropic-Provider ist die Bereinigung standardmäßig deaktiviert. Zum Aktivieren:

{
  agents: {
    defaults: {
      contextPruning: { mode: "cache-ttl", ttl: "5m" },
    },
  },
}

Zum Deaktivieren: mode: "off" setzen.

# Bereinigung vs. Compaction

	Bereinigung	Compaction
Was	Kürzt Tool-Ergebnisse	Fasst die Konversation zusammen
Gespeichert?	Nein (pro Anfrage)	Ja (im Transkript)
Umfang	Nur Tool-Ergebnisse	Gesamte Konversation

Sie ergänzen sich -- die Bereinigung hält Tool-Ausgaben zwischen Compaction-Zyklen schlank.

# Weiterführende Informationen

• Compaction -- zusammenfassungsbasierte Kontextreduktion
• Gateway-Konfiguration -- alle Konfigurationsoptionen für die Bereinigung (contextPruning.*)

# Verwandt

• Sitzungsverwaltung
• Sitzungstools
• Context engine