Context Window & Compaction in OpenClaw

Kennst du das Problem? Du arbeitest an einem komplexen Projekt und chattest lange mit der KI. Irgendwann wird die Antwortzeit langsamer oder das Model fängt an, wichtige Details vom Anfang der Konversation zu vergessen. Es nervt, wenn der Context Window voll ist und man manuell Nachrichten löschen muss, um Platz für neue Prompts zu schaffen.

Hier erfährst du, wie du dieses Problem mit Compaction löst.

Voraussetzungen

• Model-Definitionen aus dem konfigurierten Provider Catalog (bestimmt die Context-Limits).
• Zugriff auf die agents.defaults.compaction Einstellungen.

Schnellstart

In der Standardeinstellung ist Auto-compaction aktiviert. Wenn deine Session das Limit des Context Window erreicht, fasst OpenClaw die Historie automatisch zusammen.

Du kannst Compaction auch jederzeit manuell erzwingen, wenn sich die Session “zäh” anfühlt:

1. Nutze den Befehl /compact in deinem Chat.
2. Füge optional spezifische Anweisungen hinzu, worauf sich die Zusammenfassung konzentrieren soll.

/compact Focus on decisions and open questions

So funktioniert Compaction

Compaction fasst ältere Teile der Konversation in einem kompakten Summary-Eintrag zusammen. Deine neuesten Nachrichten bleiben dabei vollständig erhalten. Das Ergebnis wird direkt in der JSONL-Historie der Session gespeichert. Zukünftige Requests nutzen dann:

• Das Compaction Summary
• Die aktuellen Nachrichten, die nach dem Compaction-Punkt entstanden sind

Auto-compaction

Sobald eine Session das Limit des Context Window erreicht oder überschreitet, triggert OpenClaw die Auto-compaction. Gegebenenfalls wird der ursprüngliche Request mit dem neuen, komprimierten Context automatisch wiederholt.

Bevor die Komprimierung startet, kann OpenClaw einen silent memory flush durchführen, um wichtige Notizen auf die Festplatte zu schreiben.

Compaction vs. Pruning

Es ist wichtig, den Unterschied zu kennen:

• Compaction: Erstellt eine Zusammenfassung und speichert diese dauerhaft in der JSONL-Datei.
• Session Pruning: Kürzt nur alte Tool-Ergebnisse im Arbeitsspeicher (in-memory) pro Request.

Fehlerbehebung

Wenn du wissen willst, ob OpenClaw im Hintergrund arbeitet, helfen dir diese zwei Wege:

• Status prüfen: Gib /status ein. Du siehst dort die Zeile 🧹 Compactions: <count>, die dir verrät, wie oft komprimiert wurde.
• Verbose Mode: Wenn dieser aktiv ist, siehst du die Meldung 🧹 Auto-compaction complete direkt im Log.

Falls der Context trotz Compaction zu aufgebläht bleibt, kannst du mit /new oder /reset eine komplett neue Session-ID starten.

AI Setup Assistant

Nächste Schritte

• Compaction Konfiguration & Modi
• Memory Details
• Session Pruning Guide