Context

“Context” 是 OpenClaw 发送给模型的所有内容。它受模型的 context window（Token 限制）约束。

新手理解模型：

  • System prompt（OpenClaw 构建）：规则、工具、Skill 列表、时间/运行时信息，以及注入的 Workspace 文件。
  • 对话历史：你的消息 + 助手在本次 Session 中的消息。
  • 工具调用/结果 + 附件：命令输出、文件读取、图片/音频等。

Context 不等于”记忆”：记忆可以存储在磁盘上并稍后重新加载；Context 是模型当前窗口内的内容。

快速开始（检查 Context）

  • /status → 快速查看”我的窗口有多满？”+ Session 设置。
  • /context list → 查看注入了什么 + 大致大小（每个文件 + 总计）。
  • /context detail → 更深入的细分：每个文件、每个工具 schema 大小、每个 Skill 条目大小，以及 system prompt 大小。
  • /usage tokens → 在正常回复中附加每次回复的使用情况页脚。
  • /compact → 将旧历史记录总结为紧凑条目以释放窗口空间。

另见：Slash 命令、Token 使用与成本、Compaction。

示例输出

具体数值因模型、Provider、工具策略和 Workspace 内容而异。

/context list

🧠 Context breakdown
Workspace: <workspaceDir>
Bootstrap max/file: 20,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 Window

模型接收的所有内容都会计入，包括：

  • System prompt（所有部分）。
  • 对话历史。
  • 工具调用 + 工具结果。
  • 附件/转录（图片/音频/文件）。
  • Compaction 摘要和修剪产物。
  • Provider “包装器”或隐藏头部（不可见，但仍计数）。

OpenClaw 如何构建 System Prompt

System prompt 由 OpenClaw 拥有，每次运行时重新构建。它包括：

  • 工具列表 + 简短描述。
  • Skill 列表（仅元数据；见下文）。
  • Workspace 位置。
  • 时间（UTC + 配置的用户时间转换）。
  • Runtime 元数据（主机/操作系统/模型/思考）。
  • 在 Project Context 下注入的 Workspace Bootstrap 文件。

完整细分：System Prompt。

注入的 Workspace 文件（Project Context）

默认情况下，OpenClaw 会注入一组固定的 Workspace 文件（如果存在）：

  • AGENTS.md
  • SOUL.md
  • TOOLS.md
  • IDENTITY.md
  • USER.md
  • HEARTBEAT.md
  • BOOTSTRAP.md（仅首次运行）

大文件会使用 agents.defaults.bootstrapMaxChars（默认 20000 字符）按文件截断。/context 会显示原始大小 vs 注入大小以及是否发生了截断。

Skill：注入什么 vs 按需加载

System prompt 包含一个紧凑的 Skill 列表（名称 + 描述 + 位置）。这个列表有实际开销。

Skill 指令默认_不_包含在内。模型应该仅在需要时 read Skill 的 SKILL.md。

工具：有两种成本

工具以两种方式影响 Context：

  1. System prompt 中的工具列表文本（你看到的”Tooling”）。
  2. 工具 schema（JSON）。这些会发送给模型以便它可以调用工具。即使你看不到它们作为纯文本，它们也会计入 Context。

/context detail 会细分最大的工具 schema，这样你就能看到什么占主导地位。

命令、指令和”内联快捷方式”

Slash 命令由 Gateway 处理。有几种不同的行为：

  • 独立命令：仅包含 /... 的消息会作为命令运行。
  • 指令：/think、/verbose、/reasoning、/elevated、/model、/queue 在模型看到消息之前会被剥离。
    • 仅指令的消息会持久化 Session 设置。
    • 普通消息中的内联指令充当每条消息的提示。
  • 内联快捷方式（仅白名单发送者）：普通消息中的某些 /... Token 可以立即运行（例如：“hey /status”），并在模型看到剩余文本之前被剥离。

详情：Slash 命令。

Session、Compaction 和修剪（什么会持久化）

跨消息持久化的内容取决于机制：

  • 普通历史在 Session 转录中持久化，直到被策略压缩/修剪。
  • Compaction 将摘要持久化到转录中，并保持最近的消息完整。
  • 修剪从运行的_内存中_ prompt 中删除旧的工具结果，但不会重写转录。

文档：Session、Compaction、Session 修剪。

/context 实际报告什么

/context 优先使用最新的运行构建的 system prompt 报告（如果可用）：

  • System prompt (run) = 从最后一次嵌入式（支持工具）运行中捕获，并持久化在 Session 存储中。
  • System prompt (estimate) = 当没有运行报告时（或通过不生成报告的 CLI 后端运行时）即时计算。

无论哪种方式，它都会报告大小和主要贡献者；它不会转储完整的 system prompt 或工具 schema。