Sitzungs-Pruning
Sitzungs-Pruning kürzt vor jedem LLM-Aufruf alte Tool-Ergebnisse aus dem Kontext.
Es reduziert die Aufblähung des Kontexts durch angesammelte Tool-Ausgaben (Exec-Ergebnisse, Datei-
Lesevorgänge, Suchergebnisse), ohne normalen Konversationstext umzuschreiben.
Pruning erfolgt nur im Speicher — es verändert nicht das Sitzungsprotokoll auf dem Datenträger.
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 Kompaktierung früher als
nötig erzwingen.
Pruning ist besonders wertvoll für Anthropic-Prompt-Caching. Nachdem die Cache-
TTL abgelaufen ist, cached die nächste Anfrage den vollständigen Prompt erneut. Pruning reduziert die
Größe des Cache-Schreibvorgangs und senkt dadurch direkt die Kosten.
So funktioniert es
- Warten, bis die Cache-TTL abläuft (Standard 5 Minuten).
- Alte Tool-Ergebnisse für normales Pruning finden (Konversationstext bleibt unberührt).
- Soft-Trim für übergroße Ergebnisse — Anfang und Ende behalten,
... einfügen.
- Hard-Clear für den Rest — durch einen Platzhalter ersetzen.
- TTL zurücksetzen, damit Folgeanfragen den frischen Cache wiederverwenden.
Legacy-Bildbereinigung
OpenClaw führt außerdem eine separate idempotente Bereinigung für ältere Legacy-Sitzungen aus, die
rohe Bildblöcke im Verlauf gespeichert haben.
- Dabei bleiben die 3 zuletzt abgeschlossenen Turns Byte für Byte erhalten, damit Prompt-
Cache-Präfixe für aktuelle Folgeanfragen stabil bleiben.
- Ältere bereits verarbeitete Bildblöcke im Verlauf von
user oder toolResult können durch
[image data removed - already processed by model] ersetzt werden.
- Dies ist getrennt vom normalen Cache-TTL-Pruning. Es dient dazu, zu verhindern, dass wiederholte
Bildnutzlasten bei späteren Turns Prompt-Caches ungültig machen.
Intelligente Standardwerte
OpenClaw aktiviert Pruning automatisch für Anthropic-Profile:
| Profiltyp | Pruning aktiviert | Heartbeat |
|---|
| Anthropic OAuth-/Token-Authentifizierung (einschließlich Wiederverwendung der Claude CLI) | Ja | 1 Stunde |
| API-Key | Ja | 30 Min |
Aktivieren oder deaktivieren
Für Nicht-Anthropic-Provider ist Pruning standardmäßig deaktiviert. Zum Aktivieren:
{
agents: {
defaults: {
contextPruning: { mode: "cache-ttl", ttl: "5m" },
},
},
}
mode: "off" setzen.
Pruning vs. Kompaktierung
| Pruning | Kompaktierung |
|---|
| Was | Kürzt Tool-Ergebnisse | Fasst Unterhaltung zusammen |
| Gespeichert? | Nein (pro Anfrage) | Ja (im Protokoll) |
| Umfang | Nur Tool-Ergebnisse | Gesamte Unterhaltung |
