Context

“Context” is everything OpenClaw sends to the model for a run. It is bounded by the model’s context window (token limit).

Beginner mental model:

• System prompt (OpenClaw-built): rules, tools, skills list, time/runtime, and injected workspace files.
• Conversation history: your messages + the assistant’s messages for this session.
• Tool calls/results + attachments: command output, file reads, images/audio, etc.

Context is not the same thing as “memory”: memory can be stored on disk and reloaded later; context is what’s inside the model’s current window.

Quick start (inspect context)

• text

  Copy

  /status
  → quick “how full is my window?” view + session settings.
• text

  Copy

  /context list
  → what’s injected + rough sizes (per file + totals).
• text

  Copy

  /context detail
  → deeper breakdown: per-file, per-tool schema sizes, per-skill entry sizes, and system prompt size.
• text

  Copy

  /usage tokens
  → append per-reply usage footer to normal replies.
• text

  Copy

  /compact
  → summarize older history into a compact entry to free window space.

See also: Slash commands, Token use & costs, Compaction.

Example output

Values vary by model, provider, tool policy, and what’s in your workspace.

text

Copy

/context list

text
Copy
🧠 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

text

Copy

/context detail

text
Copy
🧠 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)

What counts toward the context window

Everything the model receives counts, including:

• System prompt (all sections).
• Conversation history.
• Tool calls + tool results.
• Attachments/transcripts (images/audio/files).
• Compaction summaries and pruning artifacts.
• Provider “wrappers” or hidden headers (not visible, still counted).

How OpenClaw builds the system prompt

The system prompt is OpenClaw-owned and rebuilt each run. It includes:

• Tool list + short descriptions.
• Skills list (metadata only; see below).
• Workspace location.
• Time (UTC + converted user time if configured).
• Runtime metadata (host/OS/model/thinking).
• Injected workspace bootstrap files under Project Context.

Full breakdown: System Prompt.

Injected workspace files (Project Context)

By default, OpenClaw injects a fixed set of workspace files (if present):

• text

  Copy

  AGENTS.md
• text

  Copy

  SOUL.md
• text

  Copy

  TOOLS.md
• text

  Copy

  IDENTITY.md
• text

  Copy

  USER.md
• text

  Copy

  HEARTBEAT.md
• text

  Copy

  BOOTSTRAP.md
  (first-run only)

Large files are truncated per-file using

(default chars). OpenClaw also enforces a total bootstrap injection cap across files with (default chars). shows raw vs injected sizes and whether truncation happened.

When truncation occurs, the runtime can inject an in-prompt warning block under Project Context. Configure this with

(, , ; default ).

Skills: injected vs loaded on-demand

The system prompt includes a compact skills list (name + description + location). This list has real overhead.

Skill instructions are not included by default. The model is expected to

the skill’s only when needed.

Tools: there are two costs

Tools affect context in two ways:

1. Tool list text in the system prompt (what you see as “Tooling”).
2. Tool schemas (JSON). These are sent to the model so it can call tools. They count toward context even though you don’t see them as plain text.

breaks down the biggest tool schemas so you can see what dominates.

Commands, directives, and "inline shortcuts"

Slash commands are handled by the Gateway. There are a few different behaviors:

• Standalone commands: a message that is only
  text

  Copy

  /...
  runs as a command.
• Directives:
  text

  Copy

  /think
  ,
  text

  Copy

  /verbose
  ,
  text

  Copy

  /trace
  ,
  text

  Copy

  /reasoning
  ,
  text

  Copy

  /elevated
  ,
  text

  Copy

  /model
  ,
  text

  Copy

  /queue
  are stripped before the model sees the message.
  • Directive-only messages persist session settings.
  • Inline directives in a normal message act as per-message hints.
• Inline shortcuts (allowlisted senders only): certain
  text

  Copy

  /...
  tokens inside a normal message can run immediately (example: “hey /status”), and are stripped before the model sees the remaining text.

Details: Slash commands.

Sessions, compaction, and pruning (what persists)

What persists across messages depends on the mechanism:

• Normal history persists in the session transcript until compacted/pruned by policy.
• Compaction persists a summary into the transcript and keeps recent messages intact.
• Pruning drops old tool results from the in-memory prompt to free context-window space, but does not rewrite the session transcript — the full history is still inspectable on disk.

Docs: Session, Compaction, Session pruning.

By default, OpenClaw uses the built-in

context engine for assembly and compaction. If you install a plugin that provides and select it with , OpenClaw delegates context assembly, , and related subagent context lifecycle hooks to that engine instead. does not auto-fallback to the legacy engine; the active engine must still implement correctly. See Context Engine for the full pluggable interface, lifecycle hooks, and configuration.

What

text

Copy

/context

actually reports

prefers the latest run-built system prompt report when available:

• text

  Copy

  System prompt (run)
  = captured from the last embedded (tool-capable) run and persisted in the session store.
• text

  Copy

  System prompt (estimate)
  = computed on the fly when no run report exists (or when running via a CLI backend that doesn’t generate the report).

Either way, it reports sizes and top contributors; it does not dump the full system prompt or tool schemas.

Related

• Context Engine — custom context injection via plugins
• Compaction — summarizing long conversations
• System Prompt — how the system prompt is built
• Agent Loop — the full agent execution cycle