Context Window & Compaction

Jedes Modell hat ein Context Window (maximale Anzahl an Tokens, die es sehen kann). Lange Chats sammeln Nachrichten und Tool-Ergebnisse an; sobald das Fenster knapp wird, komprimiert OpenClaw ältere Verläufe, um innerhalb der Limits zu bleiben.

Was ist Compaction?

Compaction fasst ältere Konversationen zusammen in einen kompakten Zusammenfassungs-Eintrag und behält aktuelle Nachrichten unverändert. Die Zusammenfassung wird im Session-Verlauf gespeichert, sodass zukünftige Anfragen nutzen:

  • Die Compaction-Zusammenfassung
  • Aktuelle Nachrichten nach dem Compaction-Punkt

Compaction bleibt dauerhaft im JSONL-Verlauf der Session erhalten.

Konfiguration

Schau dir Compaction-Konfiguration & Modi für die agents.defaults.compaction-Einstellungen an.

Auto-Compaction (standardmäßig aktiviert)

Wenn eine Session sich dem Context Window des Modells nähert oder es überschreitet, löst OpenClaw Auto-Compaction aus und wiederholt möglicherweise die ursprüngliche Anfrage mit dem komprimierten Context.

Du siehst dann:

  • 🧹 Auto-compaction complete im Verbose-Modus
  • /status zeigt 🧹 Compactions: <count>

Vor der Compaction kann OpenClaw einen stillen Memory-Flush durchführen, um dauerhafte Notizen auf die Festplatte zu schreiben. Schau dir Memory für Details und Konfiguration an.

Manuelle Compaction

Nutze /compact (optional mit Anweisungen), um eine Compaction manuell auszulösen:

/compact Focus on decisions and open questions

Context Window Quelle

Das Context Window ist modellspezifisch. OpenClaw verwendet die Modelldefinition aus dem konfigurierten Provider-Katalog, um die Limits zu bestimmen.

Compaction vs. Pruning

  • Compaction: fasst zusammen und bleibt dauerhaft in JSONL erhalten.
  • Session Pruning: kürzt nur alte Tool-Ergebnisse, im Speicher, pro Anfrage.

Schau dir /concepts/session-pruning für Details zum Pruning an.

Tipps

  • Nutze /compact, wenn Sessions veraltet wirken oder der Context aufgebläht ist.
  • Große Tool-Ausgaben werden bereits gekürzt; Pruning kann den Aufbau von Tool-Ergebnissen weiter reduzieren.
  • Wenn du einen Neustart brauchst, startet /new oder /reset eine neue Session-ID.