Kontext
„Kontext“ ist alles, was OpenClaw bei einem Durchlauf an das Modell sendet. Er ist durch das Kontextfenster des Modells (Token-Limit) begrenzt. Ein mentales Modell für Einsteiger:- System Prompt (von OpenClaw erstellt): Regeln, Tools, Skills-Liste, Zeit/Laufzeit und eingebundene Workspace-Dateien.
- Unterhaltungsverlauf: Ihre Nachrichten + die Nachrichten des Assistenten für diese Sitzung.
- Tool-Aufrufe/-Ergebnisse + Anhänge: Befehlsausgabe, Dateilesevorgänge, Bilder/Audio usw.
Schnellstart (Kontext untersuchen)
/status→ schnelle Ansicht „wie voll ist mein Fenster?“ + Sitzungseinstellungen./context list→ was eingebunden ist + grobe Größen (pro Datei + Summen)./context detail→ tiefere Aufschlüsselung: pro Datei, Größen pro Tool-Schema, Größen pro Skill-Eintrag und Größe des System Prompt./usage tokens→ hängt normalen Antworten eine Fußzeile mit der Nutzung pro Antwort an./compact→ fasst älteren Verlauf zu einem kompakten Eintrag zusammen, um Platz im Fenster freizugeben.
Beispielausgabe
Die Werte variieren je nach Modell, Anbieter, Tool-Richtlinie und dem Inhalt Ihres Workspace./context list
/context detail
Was auf das Kontextfenster angerechnet wird
Alles, was das Modell erhält, wird angerechnet, einschließlich:- System Prompt (alle Abschnitte).
- Unterhaltungsverlauf.
- Tool-Aufrufe + Tool-Ergebnisse.
- Anhänge/Transkripte (Bilder/Audio/Dateien).
- Compaction-Zusammenfassungen und Pruning-Artefakte.
- Anbieter-„Wrapper“ oder versteckte Header (nicht sichtbar, werden trotzdem mitgezählt).
Wie OpenClaw den System Prompt erstellt
Der System Prompt wird von OpenClaw verwaltet und bei jedem Durchlauf neu erstellt. Er enthält:- Tool-Liste + Kurzbeschreibungen.
- Skills-Liste (nur Metadaten; siehe unten).
- Workspace-Speicherort.
- Zeit (UTC + umgerechnete Benutzerzeit, falls konfiguriert).
- Laufzeit-Metadaten (Host/OS/Modell/Denken).
- Eingebundene Workspace-Bootstrap-Dateien unter Project Context.
Eingebundene Workspace-Dateien (Project Context)
Standardmäßig bindet OpenClaw eine feste Menge von Workspace-Dateien ein (falls vorhanden):AGENTS.mdSOUL.mdTOOLS.mdIDENTITY.mdUSER.mdHEARTBEAT.mdBOOTSTRAP.md(nur beim ersten Durchlauf)
agents.defaults.bootstrapMaxChars abgeschnitten (Standard: 12000 Zeichen). OpenClaw erzwingt außerdem über alle Dateien hinweg ein Gesamtlimit für eingebundene Bootstrap-Inhalte mit agents.defaults.bootstrapTotalMaxChars (Standard: 60000 Zeichen). /context zeigt Roh- vs. eingebundene Größen sowie an, ob eine Abschneidung erfolgt ist.
Wenn eine Abschneidung erfolgt, kann die Laufzeit im Prompt einen Warnblock unter Project Context einfügen. Konfigurieren Sie dies mit agents.defaults.bootstrapPromptTruncationWarning (off, once, always; Standard: once).
Skills: eingebunden vs. bei Bedarf geladen
Der System Prompt enthält eine kompakte Skills-Liste (Name + Beschreibung + Speicherort). Diese Liste verursacht echten Overhead. Skill-Anweisungen sind standardmäßig nicht enthalten. Vom Modell wird erwartet, dass esread für die SKILL.md eines Skills nur bei Bedarf verwendet.
Tools: Es gibt zwei Kostenarten
Tools beeinflussen den Kontext auf zwei Arten:- Tool-Listentext im System Prompt (was Sie als „Tooling“ sehen).
- Tool-Schemas (JSON). Diese werden an das Modell gesendet, damit es Tools aufrufen kann. Sie zählen zum Kontext, auch wenn Sie sie nicht als Klartext sehen.
/context detail schlüsselt die größten Tool-Schemas auf, damit Sie sehen können, was dominiert.
Befehle, Direktiven und „Inline-Verknüpfungen“
Slash-Befehle werden vom Gateway verarbeitet. Es gibt einige unterschiedliche Verhaltensweisen:- Eigenständige Befehle: Eine Nachricht, die nur aus
/...besteht, wird als Befehl ausgeführt. - Direktiven:
/think,/verbose,/trace,/reasoning,/elevated,/model,/queuewerden entfernt, bevor das Modell die Nachricht sieht.- Nachrichten, die nur aus Direktiven bestehen, behalten Sitzungseinstellungen bei.
- Inline-Direktiven in einer normalen Nachricht wirken als Hinweise pro Nachricht.
- Inline-Verknüpfungen (nur für Sender auf der Allowlist): 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.
Sitzungen, Compaction und Pruning (was bestehen bleibt)
Was über Nachrichten hinweg bestehen bleibt, hängt vom Mechanismus ab:- Normaler Verlauf bleibt im Sitzungsprotokoll erhalten, bis er gemäß Richtlinie kompaktiert oder bereinigt wird.
- Compaction speichert eine Zusammenfassung im Protokoll und lässt aktuelle Nachrichten intakt.
- Pruning entfernt alte Tool-Ergebnisse aus dem im Speicher befindlichen Prompt für einen Durchlauf, schreibt das Protokoll jedoch nicht um.
legacy-Kontext-Engine. Wenn Sie ein Plugin installieren, das kind: "context-engine" bereitstellt, und es mit plugins.slots.contextEngine auswählen, delegiert OpenClaw stattdessen die Kontextzusammenstellung, /compact und verwandte Kontext-Lebenszyklus-Hooks für Subagents an diese Engine. ownsCompaction: false führt nicht automatisch zu einem Fallback auf die Legacy-Engine; die aktive Engine muss compact() dennoch korrekt implementieren. Siehe Context Engine für die vollständige steckbare Schnittstelle, Lebenszyklus-Hooks und Konfiguration.
Was /context tatsächlich meldet
/context bevorzugt, wenn verfügbar, den neuesten im Durchlauf erstellten Bericht zum System Prompt:
System prompt (run)= aus dem letzten eingebetteten (Tool-fähigen) Durchlauf erfasst und im Sitzungsspeicher persistent gespeichert.System prompt (estimate)= spontan berechnet, wenn kein Durchlaufbericht existiert (oder bei Ausführung über ein CLI-Backend, das den Bericht nicht erzeugt).
Verwandt
- Context Engine — benutzerdefinierte Kontexteinbindung über Plugins
- Compaction — Zusammenfassen langer Unterhaltungen
- System Prompt — wie der System Prompt erstellt wird
- Agent Loop — der vollständige Ausführungszyklus des Agenten