上下文

“上下文”就是 OpenClaw 在一次运行中发送给模型的全部内容。它受模型的上下文窗口（token 上限）约束。

简单理解：

系统提示词（OpenClaw 构建）：规则、工具、skills 列表、时间/运行时信息，以及注入的工作区文件。
对话历史：当前会话中你的消息和 assistant 的消息。
工具调用/结果 + 附件：命令输出、文件读取、图片/音频等。

上下文和”记忆”不是一回事：记忆可以存到磁盘、以后再加载；上下文是模型当前窗口里的东西。

快速上手（检查上下文）

/status → 快速查看”我的窗口用了多少” + 会话设置。
/context list → 查看注入了什么 + 大致大小（按文件和总计）。
/context detail → 更详细的拆分：每个文件、每个工具 schema、每个 skill 条目的大小，以及系统提示词大小。
/usage tokens → 在回复后面附上每次回复的用量统计。
/compact → 把较早的历史总结为紧凑条目，释放窗口空间。

另见：斜杠命令、Token 用量与成本、Compaction。

示例输出

实际值因模型、provider、工具策略和工作区内容而异。

`/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)

什么会占用上下文窗口

发送给模型的一切都算在内：

系统提示词（所有部分）。
对话历史。
工具调用 + 工具结果。
附件/转录（图片/音频/文件）。
Compaction 摘要和裁剪产物。
Provider 的”包装”或隐藏头部（你看不到，但依然计数）。

OpenClaw 如何构建系统提示词

系统提示词由 OpenClaw 负责，每次运行时重新构建。包含：

工具列表 + 简短描述。
Skills 列表（仅元数据，见下文）。
工作区位置。
时间（UTC + 如果配置了用户时区则显示转换后的时间）。
运行时元数据（主机/操作系统/模型/thinking 模式）。
注入的工作区 bootstrap 文件，放在 Project Context 下。

详细拆分：系统提示词。

注入的工作区文件（Project Context）

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

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

大文件按 agents.defaults.bootstrapMaxChars（默认 20000 字符）截断。OpenClaw 还通过 agents.defaults.bootstrapTotalMaxChars（默认 150000 字符）限制所有文件注入的总量。/context 会显示原始 vs 注入的大小以及是否发生了截断。

发生截断时，运行时可以在 Project Context 下注入一个提示警告块。通过 agents.defaults.bootstrapPromptTruncationWarning 配置（off、once、always，默认 once）。

Skills：注入 vs 按需加载

系统提示词包含一个紧凑的 skills 列表（名称 + 描述 + 位置）。这个列表有实际的上下文开销。

Skill 的详细指令默认不包含在提示词中。模型需要的时候应该自己 read skill 的 SKILL.md。

工具：两方面的开销

工具在两个方面影响上下文：

工具列表文本（系统提示词中你看到的 “Tooling” 部分）。
工具 schema（JSON）。发送给模型以便它调用工具。它们占用上下文空间，但你看不到它们的明文。

/context detail 会列出最大的工具 schema，方便你看到哪些工具占用最多。

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

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

独立命令：消息内容只有 /... 时，作为命令执行。
指令：/think、/verbose、/reasoning、/elevated、/model、/queue 在发给模型之前会被剥离。
- 只包含指令的消息会持久化会话设置。
- 在普通消息中内联的指令作为单次提示。
内联快捷方式（仅限白名单发送者）：普通消息中的某些 /... 标记可以立即执行（例如 “hey /status”），执行后从剩余文本中移除。

详情：斜杠命令。

会话、compaction 和裁剪（持久化机制）

不同机制下，什么会跨消息保留：

普通历史：保存在会话记录中，直到被策略 compact 或裁剪。
Compaction：把摘要持久化到记录中，保留最近的消息。
裁剪：从运行时的内存中提示词里移除旧的工具结果，但不改写记录文件。

相关文档：会话、Compaction、会话裁剪。

默认情况下，OpenClaw 使用内置的 legacy 上下文引擎来组装和 compact。如果你安装了一个提供 kind: "context-engine" 的插件，并通过 plugins.slots.contextEngine 选择它，OpenClaw 会把上下文组装、/compact 和相关的子 agent 上下文生命周期 hook 都委托给该引擎。

`/context` 实际报告什么

/context 优先使用最近一次运行时构建的系统提示词报告：

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

两种情况都会报告大小和主要贡献者；不会输出完整的系统提示词或工具 schema。

上下文