Kontext

„Kontext“ ist alles, was OpenClaw für einen Lauf an das Modell sendet. Er wird durch das Kontextfenster des Modells begrenzt (Token-Limit).

Einsteiger-Mentalmodell:

• System-Prompt (von OpenClaw erstellt): Regeln, Werkzeuge, Skills-Liste, Zeit/Laufzeit und injizierte Workspace-Dateien.
• Konversationsverlauf: Ihre Nachrichten + die Nachrichten des Assistenten für diese Sitzung.
• Werkzeugaufrufe/-ergebnisse + Anhänge: Befehlsausgabe, gelesene Dateien, Bilder/Audio usw.

Kontext ist nicht dasselbe wie „Memory“: Memory kann auf der Festplatte gespeichert und später erneut geladen werden; Kontext ist das, was sich im aktuellen Fenster des Modells befindet.

Schnellstart (Kontext prüfen)

• /status → schnelle Ansicht „Wie voll ist mein Fenster?“ + Sitzungseinstellungen.
• /context list → was injiziert wurde + grobe Größen (pro Datei + Summen).
• /context detail → detailliertere Aufschlüsselung: Größen pro Datei, pro Werkzeugschema, pro Skill-Eintrag, System-Prompt-Größe und Anzahl kompaktierbarer Transkriptnachrichten.
• /context map → WinDirStat-artige Treemap-Grafik der aktuell nachverfolgten Kontextbeiträge der Sitzung.
• /usage tokens → Nutzungsfooter pro Antwort an normale Antworten anhängen.
• /compact → älteren Verlauf zu einem kompakten Eintrag zusammenfassen, um Fensterplatz freizugeben.

Siehe auch: Slash-Befehle, Token-Nutzung & Kosten, Compaction.

Beispielausgabe

Werte variieren je nach Modell, Provider, Werkzeugrichtlinie und Inhalt Ihres Workspaces.

/context list

🧠 Context breakdownWorkspace: <workspaceDir>Bootstrap max/file: 12,000 charsSandbox: mode=non-main sandboxed=falseSystem 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

/context detail

🧠 Context breakdown (detailed)…Top skills (prompt entry size):- frontend-design: 412 chars (~103 tok)- oracle: 401 chars (~101 tok)… (+10 more skills) Top tools (schema size):- browser: 9,812 chars (~2,453 tok)- exec: 6,240 chars (~1,560 tok)… (+N more tools)

/context map

Sendet ein Bild, das aus dem neuesten zwischengespeicherten Laufbericht generiert wird. Bevor eine normale Nachricht in der Sitzung einen Laufbericht erzeugt hat, gibt /context map statt einer geschätzten Darstellung eine Nicht-verfügbar-Meldung zurück. Die Rechteckfläche ist proportional zu den nachverfolgten Prompt-Zeichen:

• injizierte Workspace-Dateien
• Basistext des System-Prompts
• Skill-Prompt-Einträge
• Werkzeug-JSON-Schemas

/context list, /context detail und /context json können weiterhin eine On-Demand-Schätzung prüfen, wenn kein Laufbericht zwischengespeichert ist.

Was zum Kontextfenster zählt

Alles, was das Modell erhält, zählt, einschließlich:

• System-Prompt (alle Abschnitte).
• Konversationsverlauf.
• Werkzeugaufrufe + Werkzeugergebnisse.
• Anhänge/Transkripte (Bilder/Audio/Dateien).
• Compaction-Zusammenfassungen und Pruning-Artefakte.
• Provider-„Wrapper“ oder versteckte Header (nicht sichtbar, zählen trotzdem).

Wie OpenClaw den System-Prompt erstellt

Der System-Prompt ist OpenClaw-eigen und wird bei jedem Lauf neu erstellt. Er enthält:

• Werkzeugliste + kurze Beschreibungen.
• Skills-Liste (nur Metadaten; siehe unten).
• Workspace-Speicherort.
• Zeit (UTC + umgerechnete Benutzerzeit, falls konfiguriert).
• Laufzeitmetadaten (Host/OS/Modell/Thinking).
• Injizierte Workspace-Bootstrap-Dateien unter Project Context.

Vollständige Aufschlüsselung: System-Prompt.

Injizierte Workspace-Dateien (Project Context)

Standardmäßig injiziert OpenClaw einen festen Satz von Workspace-Dateien (falls vorhanden):

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

Große Dateien werden pro Datei mit agents.defaults.bootstrapMaxChars gekürzt (Standard 20000 Zeichen). OpenClaw erzwingt außerdem eine Gesamtobergrenze für die Bootstrap-Injektion über alle Dateien hinweg mit agents.defaults.bootstrapTotalMaxChars (Standard 60000 Zeichen). /context zeigt Größen für roh vs. injiziert und ob eine Kürzung stattgefunden hat.

Wenn eine Kürzung erfolgt, kann die Laufzeit einen Warnblock im Prompt unter Project Context injizieren. Konfigurieren Sie dies mit agents.defaults.bootstrapPromptTruncationWarning (off, once, always; Standard always).

Skills: injiziert vs. bei Bedarf geladen

Der System-Prompt enthält eine kompakte Skills-Liste (Name + Beschreibung + Speicherort). Diese Liste hat echten Overhead.

Skill-Anweisungen sind standardmäßig nicht enthalten. Es wird erwartet, dass das Modell die SKILL.md des Skills nur bei Bedarf per read liest.

Werkzeuge: Es gibt zwei Kosten

Werkzeuge beeinflussen den Kontext auf zwei Arten:

1. Werkzeuglistentext im System-Prompt (was Sie als „Tooling“ sehen).
2. Werkzeugschemas (JSON). Diese werden an das Modell gesendet, damit es Werkzeuge aufrufen kann. Sie zählen zum Kontext, auch wenn Sie sie nicht als Klartext sehen.

/context detail schlüsselt die größten Werkzeugschemas auf, damit Sie sehen können, was dominiert.

Befehle, Direktiven und „Inline-Kurzbefehle“

Slash-Befehle werden vom Gateway verarbeitet. Es gibt einige unterschiedliche Verhaltensweisen:

• Eigenständige Befehle: Eine Nachricht, die nur /... enthält, wird als Befehl ausgeführt.
• Direktiven: /think, /verbose, /trace, /reasoning, /elevated, /model, /queue werden entfernt, bevor das Modell die Nachricht sieht.
  • Nachrichten, die nur Direktiven enthalten, speichern Sitzungseinstellungen dauerhaft.
  • Inline-Direktiven in einer normalen Nachricht wirken als Hinweise pro Nachricht.
• Inline-Kurzbefehle (nur erlaubte Absender): Bestimmte /...-Tokens innerhalb einer normalen Nachricht können sofort ausgeführt werden (Beispiel: „hey /status“) und werden entfernt, bevor das Modell den restlichen Text sieht.

Details: Slash-Befehle.

Sitzungen, Compaction und Pruning (was erhalten bleibt)

Was über Nachrichten hinweg erhalten bleibt, hängt vom Mechanismus ab:

• Normaler Verlauf bleibt im Sitzungstranskript erhalten, bis er durch Richtlinie kompaktiert/gepruned wird.
• Compaction speichert eine Zusammenfassung im Transkript und lässt aktuelle Nachrichten unverändert.
• Pruning entfernt alte Werkzeugergebnisse aus dem im Arbeitsspeicher befindlichen Prompt, um Platz im Kontextfenster freizugeben, schreibt das Sitzungstranskript aber nicht um - der vollständige Verlauf bleibt weiterhin auf der Festplatte prüfbar.

Dokumentation: Sitzung, Compaction, Sitzungs-Pruning.

Standardmäßig verwendet OpenClaw die integrierte legacy-Kontext-Engine für Zusammenstellung und Compaction. Wenn Sie ein Plugin installieren, das kind: "context-engine" bereitstellt, und es mit plugins.slots.contextEngine auswählen, delegiert OpenClaw die Kontext- Zusammenstellung, /compact und zugehörige Subagent-Kontext-Lifecycle-Hooks stattdessen an diese Engine. ownsCompaction: false führt nicht automatisch zu einem Fallback auf die legacy- Engine; die aktive Engine muss compact() weiterhin korrekt implementieren. Siehe Kontext-Engine für die vollständige Plugin-fähige Schnittstelle, Lifecycle-Hooks und Konfiguration.

Was /context tatsächlich meldet

/context bevorzugt den neuesten laufgebauten System-Prompt-Bericht, wenn verfügbar:

• System prompt (run) = aus dem letzten eingebetteten (werkzeugfähigen) Lauf erfasst und im Sitzungsspeicher persistiert.
• System prompt (estimate) = spontan berechnet, wenn kein Laufbericht existiert (oder wenn die Ausführung über ein CLI-Backend erfolgt, das den Bericht nicht erzeugt).

In beiden Fällen werden Größen und wichtigste Beiträge gemeldet; der vollständige System-Prompt oder die Werkzeugschemas werden nicht ausgegeben. Im Detailmodus vergleicht es außerdem das Sitzungstranskript mit demselben Prädikat für echte Konversationsnachrichten, das von Compaction verwendet wird, sodass hohe Prompt-/Cache-Nutzung leichter von kompaktierbarem Konversationsverlauf zu unterscheiden ist.

Verwandt