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.
Die Bereinigung erfolgt nur im Speicher — sie verändert nicht das Sitzungs-Transkript auf der Festplatte.
Ihr vollständiger Verlauf bleibt immer erhalten.
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
- Warten, bis die Cache-TTL abläuft (standardmäßig 5 Minuten).
- Alte Tool-Ergebnisse für die normale Bereinigung finden (Konversationstext bleibt unberührt).
- Übergroße Ergebnisse weich kürzen — Anfang und Ende beibehalten,
... einfügen.
- Den Rest hart leeren — durch einen Platzhalter ersetzen.
- 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 |
Aktivieren oder deaktivieren
Für Nicht-Anthropic-Provider ist die Bereinigung standardmäßig deaktiviert. Zum Aktivieren:
{
agents: {
defaults: {
contextPruning: { mode: "cache-ttl", ttl: "5m" },
},
},
}
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 |
Verwandt
