Context in OpenClaw verstehen

Kennst du das? Du arbeitest an einem komplexen Projekt und plötzlich fängt das Model an, Details zu vergessen oder Halluzinationen zu produzieren. Meistens liegt das daran, dass das Context Window voll ist oder du schlicht nicht weißt, welche Informationen eigentlich beim Model ankommen.

In OpenClaw ist Context nicht einfach nur “Speicher”. Es ist die Summe aller Daten, die bei einem Run an das Model übertragen werden. Wenn du verstehst, wie dieser Context aufgebaut ist, kannst du präzisere Ergebnisse erzielen und Token-Kosten sparen.

Voraussetzungen

• Eine aktive OpenClaw-Instanz
• Workspace-Dateien (optional, z. B. AGENTS.md, USER.md)
• Ein konfiguriertes Model mit definiertem Context Window

Schnellstart

Um in weniger als 5 Minuten zu verstehen, was in deinem Context passiert, nutzt du diese Slash Commands direkt im Terminal:

1. /status: Zeigt dir sofort, wie voll dein Fenster ist und welche Session-Settings aktiv sind.
2. /context list: Listet alle injizierten Dateien und deren ungefähre Größe auf.
3. /context detail: Gibt dir eine tiefe Analyse der System Prompt Größe, Tool-Schemas und Skill-Einträge.
4. /usage tokens: Fügt jeder Antwort einen Footer mit dem Token-Verbrauch hinzu.
5. /compact: Fasst den bisherigen Verlauf zusammen, um Platz im Fenster zu schaffen.

Was zählt zum Context?

Context ist alles, was innerhalb des aktuellen Model-Fensters liegt. Das ist ein wichtiger Unterschied zu “Memory”, das auf der Disk liegt und später geladen werden kann.

OpenClaw baut den System Prompt bei jedem Run neu auf. Er besteht aus:

• System Prompt: Regeln, Tools, Skills und injizierte Workspace-Dateien.
• Conversation History: Deine Nachrichten und die Antworten des Assistants.
• Tool Calls & Results: Ausgaben von Befehlen, gelesene Dateien oder Bilder.
• Provider Wrapper: Versteckte Header der API-Anbieter.

Workspace Files (Project Context)

Standardmäßig sucht OpenClaw nach bestimmten Dateien in deinem Workspace und injiziert sie:

• AGENTS.md, SOUL.md, TOOLS.md
• IDENTITY.md, USER.md, HEARTBEAT.md
• BOOTSTRAP.md (nur beim ersten Run)

Große Dateien werden automatisch gekürzt, standardmäßig bei 20.000 Zeichen (bootstrapMaxChars).

Beispiel für /context list

So sieht die Analyse aus, wenn du den Befehl ausführst:

🧠 Context breakdown
Workspace: <workspaceDir>
Bootstrap max/file: 20,000 chars
Sandbox: mode=non-main sandboxed=false
System prompt (run): 38,412 chars (~9,603 tok) (Project Context 23,901 chars (~5,976 tok))

Injected workspace files:
- AGENTS.md: OK | raw 1,742 chars (~436 tok) | injected 1,742 chars (~436 tok)
- SOUL.md: OK | raw 912 chars (~228 tok) | injected 912 chars (~228 tok)
- TOOLS.md: TRUNCATED | raw 54,210 chars (~13,553 tok) | injected 20,962 chars (~5,241 tok)
- IDENTITY.md: OK | raw 211 chars (~53 tok) | injected 211 chars (~53 tok)
- USER.md: OK | raw 388 chars (~97 tok) | injected 388 chars (~97 tok)
- HEARTBEAT.md: MISSING | raw 0 | injected 0
- BOOTSTRAP.md: OK | raw 0 chars (~0 tok) | injected 0 chars (~0 tok)

Skills list (system prompt text): 2,184 chars (~546 tok) (12 skills)
Tools: read, edit, write, exec, process, browser, message, sessions_send, …
Tool list (system prompt text): 1,032 chars (~258 tok)
Tool schemas (JSON): 31,988 chars (~7,997 tok) (counts toward context; not shown as text)
Tools: (same as above)

Session tokens (cached): 14,250 total / ctx=32,000

Tools und Skills: Die versteckten Kosten

Tools belasten deinen Context auf zwei Arten. Erstens durch den Beschreibungstext im System Prompt. Zweitens durch die Tool Schemas (JSON). Diese Schemas sind notwendig, damit das Model die Tools korrekt aufrufen kann, verbrauchen aber oft mehr Token als der eigentliche Text. Mit /context detail siehst du, welche Schemas den meisten Platz einnehmen.

Bei Skills ist OpenClaw effizienter: Im System Prompt landet nur eine kompakte Liste (Name, Beschreibung, Ort). Die eigentlichen Instruktionen (SKILL.md) liest das Model nur dann mit dem read Tool, wenn es sie wirklich braucht.

Fehlerbehebung

Wenn der Context nicht so aussieht, wie du erwartest, checke diese Punkte:

• Datei wird als TRUNCATED angezeigt: Die Datei überschreitet agents.defaults.bootstrapMaxChars. Du musst die Datei aufteilen oder das Limit anpassen.
• Datei ist MISSING: OpenClaw findet die Datei nicht im Workspace-Pfad. Überprüfe die Schreibweise (alles Großbuchstaben).
• Hoher Token-Verbrauch durch Tools: Nutze /context detail, um herauszufinden, welches Tool-Schema (z. B. browser oder exec) den Context aufbläht.
• Model “vergisst” den Anfang: Nutze /compact, um die History zusammenzufassen und Platz für neue Nachrichten zu schaffen.

Hast du Fragen zur Einrichtung? Nutze den AI Setup Assistant.

Nächste Schritte

• Slash commands
• Token use & costs
• Compaction
• System Prompt