> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Info>
  Die Bereinigung erfolgt nur im Speicher -- sie verändert nicht das Sitzungs-Transkript auf der Festplatte.
  Ihr vollständiger Verlauf bleibt immer erhalten.
</Info>

## Warum das wichtig ist

Lange Sitzungen sammeln Tool-Ausgaben an, die das Kontextfenster aufblähen. Das
erhöht die Kosten und kann [Compaction](/de/concepts/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:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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](/de/concepts/compaction) -- zusammenfassungsbasierte Kontextreduktion
* [Gateway-Konfiguration](/de/gateway/configuration) -- alle Konfigurationsoptionen für die Bereinigung
  (`contextPruning.*`)

## Verwandt

* [Sitzungsverwaltung](/de/concepts/session)
* [Sitzungstools](/de/concepts/session-tool)
* [Context engine](/de/concepts/context-engine)