Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

“Context” is alles wat OpenClaw voor een run naar het model stuurt. Het wordt begrensd door het contextvenster van het model (tokenlimiet). Beginnersmodel:
  • 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.
  • Tool-aanroepen/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.

​
Snelstart (context inspecteren)

  • /status → snelle “hoe vol is mijn venster?”-weergave + sessie-instellingen.
  • /context list → wat er is geïnjecteerd + ruwe groottes (per bestand + totalen).
  • /context detail → diepere uitsplitsing: groottes per bestand, per toolschema, per Skills-vermelding en systeempromptgrootte.
  • /usage tokens → voeg een gebruiksfooter per antwoord toe aan normale antwoorden.
  • /compact → vat oudere geschiedenis samen in een compacte vermelding om vensterruimte vrij te maken.
Zie ook: Slash-opdrachten, Tokengebruik en kosten, Compaction.

​
Voorbeelduitvoer

Waarden verschillen per model, provider, toolbeleid en wat er in je werkruimte staat.

​
/context list

🧠 Context breakdown
Workspace: <workspaceDir>
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)

​
Wat meetelt voor het contextvenster

Alles wat het model ontvangt telt mee, waaronder:
  • Systeemprompt (alle secties).
  • Gespreksgeschiedenis.
  • Tool-aanroepen + toolresultaten.
  • Bijlagen/transcripten (afbeeldingen/audio/bestanden).
  • Compaction-samenvattingen en opschoningsartefacten.
  • “Wrappers” of verborgen headers van providers (niet zichtbaar, tellen wel mee).

​
Hoe OpenClaw de systeemprompt opbouwt

De systeemprompt is eigendom van OpenClaw en wordt bij elke run opnieuw opgebouwd. Deze bevat:
  • Toollijst + korte beschrijvingen.
  • Skills-lijst (alleen metadata; zie hieronder).
  • Werkruimtelocatie.
  • Tijd (UTC + omgezette gebruikerstijd indien geconfigureerd).
  • Runtime-metadata (host/OS/model/thinking).
  • Geïnjecteerde werkruimte-bootstrapbestanden onder Projectcontext.
Volledige uitsplitsing: Systeemprompt.

​
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 bij eerste run)
Grote bestanden worden per bestand afgekapt met agents.defaults.bootstrapMaxChars (standaard 12000 tekens). OpenClaw dwingt ook een totale limiet af voor bootstrapinjectie over bestanden heen met agents.defaults.bootstrapTotalMaxChars (standaard 60000 tekens). /context toont ruwe versus geïnjecteerde groottes 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 once).

​
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 read alleen 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. Toolschema’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 toolschema’s uit, zodat je kunt zien wat domineert.

​
Opdrachten, richtlijnen en “inline snelkoppelingen”

Slash-opdrachten worden afgehandeld door de Gateway. Er zijn een paar verschillende gedragingen:
  • Losstaande opdrachten: een bericht dat alleen /... is, wordt als opdracht uitgevoerd.
  • Richtlijnen: /think, /verbose, /trace, /reasoning, /elevated, /model, /queue worden verwijderd voordat het model het bericht ziet.
    • Berichten met alleen een richtlijn behouden sessie-instellingen.
    • Inline richtlijnen in een normaal bericht werken als hints per bericht.
  • Inline snelkoppelingen (alleen toegestane afzenders): bepaalde /...-tokens binnen een normaal bericht kunnen direct worden uitgevoerd (voorbeeld: “hey /status”) en worden verwijderd voordat het model de resterende tekst ziet.
Details: Slash-opdrachten.

​
Sessies, Compaction en opschonen (wat blijft bestaan)

Wat tussen berichten blijft bestaan, hangt af van het mechanisme:
  • Normale geschiedenis blijft bestaan in het sessietranscript totdat deze volgens beleid wordt gecompacteerd/opgeschoond.
  • Compaction bewaart een samenvatting in het transcript en houdt recente berichten intact.
  • Opschonen 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 inspecteerbaar op schijf.
Documentatie: Sessie, Compaction, Sessies opschonen. Standaard gebruikt OpenClaw de ingebouwde legacy context-engine 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 Context-engine voor de volledige pluggable interface, lifecycle-hooks en configuratie.

​
Wat /context daadwerkelijk rapporteert

/context geeft de voorkeur aan het nieuwste door de run gebouwde systeempromptrapport wanneer beschikbaar:
  • System prompt (run) = vastgelegd uit de laatste ingebedde (tool-capabele) 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 toolschema’s.

​
Gerelateerd