--- read_when: - Je wilt begrijpen wat "context" betekent in OpenClaw - Je debugt waarom het model iets "weet" (of het is vergeten) - Je wilt contextoverhead verminderen (/context, /status, /compact) summary: 'Context: wat het model ziet, hoe het wordt opgebouwd en hoe je het inspecteert' title: Context x-i18n: generated_at: "2026-06-27T17:25:45Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 900b4a72acf43405a6b7718b93c3b5c8543eb2cc90766298889052c7468e39fb source_path: concepts/context.md workflow: 16 --- "Context" is **alles wat OpenClaw voor een run naar het model stuurt**. Het wordt begrensd door het **contextvenster** van het model (tokenlimiet). Mentaal model voor beginners: - **Systeemprompt** (door OpenClaw gebouwd): regels, tools, Skills-lijst, tijd/runtime en geïnjecteerde werkruimtebestanden. - **Gespreksgeschiedenis**: jouw berichten + de berichten van de assistent voor deze sessie. - **Toolaanroepen/resultaten + bijlagen**: opdrachtuitvoer, gelezen bestanden, afbeeldingen/audio, enz. Context is _niet hetzelfde_ als "geheugen": geheugen kan op schijf worden opgeslagen en later opnieuw worden geladen; context is wat zich in het huidige venster van het model bevindt. ## Snel aan de slag (context inspecteren) - `/status` → snelle weergave "hoe vol is mijn venster?" + sessie-instellingen. - `/context list` → wat is geïnjecteerd + ruwe groottes (per bestand + totalen). - `/context detail` → diepere uitsplitsing: per-bestand, groottes van tool-schema's, groottes van Skills-items, grootte van de systeemprompt en aantallen transcriptberichten die compacteerbaar zijn. - `/context map` → WinDirStat-achtige treemap-afbeelding van de bijgehouden contextbijdragers van de huidige sessie. - `/usage tokens` → voeg een gebruiksvoetregel per antwoord toe aan normale antwoorden. - `/compact` → vat oudere geschiedenis samen in een compacte vermelding om vensterruimte vrij te maken. Zie ook: [Slash-commands](/nl/tools/slash-commands), [Tokengebruik en kosten](/nl/reference/token-use), [Compaction](/nl/concepts/compaction). ## Voorbeelduitvoer Waarden verschillen per model, provider, toolbeleid en wat er in je werkruimte staat. ### `/context list` ``` 🧠 Context breakdown Workspace: Bootstrap max/file: 12,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 ``` ### `/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` Stuurt een afbeelding die is gegenereerd op basis van het nieuwste gecachete runrapport. Voordat een normaal bericht een runrapport in de sessie heeft geproduceerd, geeft `/context map` een bericht dat de functie niet beschikbaar is terug in plaats van een schatting te renderen. De oppervlakte van rechthoeken is evenredig met bijgehouden prompttekens: - geïnjecteerde werkruimtebestanden - basistekst van de systeemprompt - Skills-promptitems - JSON-schema's van tools `/context list`, `/context detail` en `/context json` kunnen nog steeds een schatting op aanvraag inspecteren wanneer er geen runrapport is gecachet. ## Wat meetelt voor het contextvenster Alles wat het model ontvangt telt mee, waaronder: - Systeemprompt (alle secties). - Gespreksgeschiedenis. - Toolaanroepen + toolresultaten. - Bijlagen/transcripten (afbeeldingen/audio/bestanden). - Compaction-samenvattingen en snoei-artefacten. - Provider-"wrappers" of verborgen headers (niet zichtbaar, tellen nog steeds mee). ## Hoe OpenClaw de systeemprompt bouwt De systeemprompt is **eigendom van OpenClaw** en wordt bij elke run opnieuw gebouwd. Deze bevat: - Toollijst + korte beschrijvingen. - Skills-lijst (alleen metadata; zie hieronder). - Werkruimtelocatie. - Tijd (UTC + geconverteerde gebruikerstijd indien geconfigureerd). - Runtime-metadata (host/OS/model/denken). - Geïnjecteerde werkruimte-bootstrapbestanden onder **Projectcontext**. Volledige uitsplitsing: [Systeemprompt](/nl/concepts/system-prompt). ## Geïnjecteerde werkruimtebestanden (Projectcontext) Standaard injecteert OpenClaw een vaste set werkruimtebestanden (indien aanwezig): - `AGENTS.md` - `SOUL.md` - `TOOLS.md` - `IDENTITY.md` - `USER.md` - `HEARTBEAT.md` - `BOOTSTRAP.md` (alleen eerste run) Grote bestanden worden per bestand afgekapt met `agents.defaults.bootstrapMaxChars` (standaard `20000` tekens). OpenClaw handhaaft ook een totale limiet voor bootstrap-injectie over bestanden heen met `agents.defaults.bootstrapTotalMaxChars` (standaard `60000` tekens). `/context` toont groottes van **onbewerkt versus geïnjecteerd** en of er afkapping heeft plaatsgevonden. Wanneer afkapping optreedt, kan de runtime een waarschuwingsblok in de prompt injecteren onder Projectcontext. Configureer dit met `agents.defaults.bootstrapPromptTruncationWarning` (`off`, `once`, `always`; standaard `always`). ## Skills: geïnjecteerd versus op aanvraag geladen De systeemprompt bevat een compacte **Skills-lijst** (naam + beschrijving + locatie). Deze lijst heeft echte overhead. Skills-instructies worden standaard _niet_ opgenomen. Van het model wordt verwacht dat het de `SKILL.md` van de Skill **alleen leest wanneer nodig**. ## Tools: er zijn twee kosten Tools beïnvloeden context op twee manieren: 1. **Toollijsttekst** in de systeemprompt (wat je ziet als "Tooling"). 2. **Tool-schema's** (JSON). Deze worden naar het model gestuurd zodat het tools kan aanroepen. Ze tellen mee voor context, ook al zie je ze niet als platte tekst. `/context detail` splitst de grootste tool-schema's uit, zodat je kunt zien wat domineert. ## Commands, richtlijnen en "inline snelkoppelingen" Slash-commands worden afgehandeld door de Gateway. Er zijn een paar verschillende gedragingen: - **Losstaande commands**: een bericht dat alleen `/...` is, wordt als command uitgevoerd. - **Richtlijnen**: `/think`, `/verbose`, `/trace`, `/reasoning`, `/elevated`, `/model`, `/queue` worden verwijderd voordat het model het bericht ziet. - Berichten die alleen uit een richtlijn bestaan, bewaren sessie-instellingen. - Inline richtlijnen in een normaal bericht fungeren als hints per bericht. - **Inline snelkoppelingen** (alleen toegestane afzenders): bepaalde `/...`-tokens in een normaal bericht kunnen direct worden uitgevoerd (voorbeeld: "hey /status") en worden verwijderd voordat het model de resterende tekst ziet. Details: [Slash-commands](/nl/tools/slash-commands). ## Sessies, Compaction en snoeien (wat blijft bestaan) Wat tussen berichten blijft bestaan, hangt af van het mechanisme: - **Normale geschiedenis** blijft bestaan in het sessietranscript totdat deze door beleid wordt gecompacteerd/gesnoeid. - **Compaction** bewaart een samenvatting in het transcript en houdt recente berichten intact. - **Snoeien** verwijdert oude toolresultaten uit de _in-memory_ prompt om ruimte in het contextvenster vrij te maken, maar herschrijft het sessietranscript niet - de volledige geschiedenis blijft op schijf inspecteerbaar. Docs: [Sessie](/nl/concepts/session), [Compaction](/nl/concepts/compaction), [Sessiesnoei](/nl/concepts/session-pruning). Standaard gebruikt OpenClaw de ingebouwde `legacy`-contextengine voor assemblage en Compaction. Als je een Plugin installeert die `kind: "context-engine"` biedt en deze selecteert met `plugins.slots.contextEngine`, delegeert OpenClaw contextassemblage, `/compact` en gerelateerde lifecycle-hooks voor subagentcontext in plaats daarvan aan die engine. `ownsCompaction: false` valt niet automatisch terug op de legacy-engine; de actieve engine moet `compact()` nog steeds correct implementeren. Zie [Contextengine](/nl/concepts/context-engine) voor de volledige pluggable interface, lifecycle-hooks en configuratie. ## Wat `/context` daadwerkelijk rapporteert `/context` geeft de voorkeur aan het nieuwste **door run gebouwde** systeempromptrapport wanneer beschikbaar: - `System prompt (run)` = vastgelegd uit de laatste ingebedde (tool-geschikte) run en opgeslagen in de sessiestore. - `System prompt (estimate)` = direct berekend wanneer er geen runrapport bestaat (of wanneer wordt uitgevoerd via een CLI-backend die het rapport niet genereert). Hoe dan ook rapporteert het groottes en belangrijkste bijdragers; het dumpt **niet** de volledige systeemprompt of tool-schema's. In gedetailleerde modus vergelijkt het ook het sessietranscript met hetzelfde predicaat voor echte gespreksberichten dat door Compaction wordt gebruikt, zodat hoog prompt-/cachegebruik makkelijker te onderscheiden is van compacteerbare gespreksgeschiedenis. ## Gerelateerd Aangepaste contextinjectie via plugins. Lange gesprekken samenvatten om ze binnen het modelvenster te houden. Hoe de systeemprompt wordt gebouwd en wat deze bij elke beurt injecteert. De volledige uitvoeringscyclus van de agent, van inkomend bericht tot definitief antwoord.