Context（上下文）

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

初学者心智模型：

• 系统提示（OpenClaw 构建）：规则、工具、Skills 列表、时间/运行时信息，以及注入的 Workspace 文件。
• 对话历史：你的消息 + 本会话中 Assistant 的回复。
• 工具调用/结果 + 附件：命令输出、文件内容、图片/音频等。

上下文不等于"记忆"：记忆可以存到磁盘并在之后重新加载；上下文是当前模型窗口中的内容。

快速上手（查看上下文）

• /status → 快速查看"窗口还剩多少"以及会话设置。
• /context list → 已注入的内容及大致大小（每个文件 + 合计）。
• /context detail → 更详细的分类：每个文件大小、每个工具 Schema 大小、每个 Skill 条目大小、系统提示大小。
• /usage tokens → 在每次回复末尾追加 token 用量统计。
• /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)

哪些内容计入上下文窗口

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

• 系统提示（所有部分）
• 对话历史
• 工具调用 + 工具结果
• 附件/转录（图片/音频/文件）
• Compaction 摘要和 Pruning 残留
• Provider 的"封装层"或隐藏头部（不可见，但仍计入）

OpenClaw 如何构建系统提示

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

• 工具列表 + 简短说明。
• Skills 列表（仅元数据，详见下文）。
• Workspace 路径。
• 时间（UTC + 已配置的用户本地时间）。
• 运行时元数据（宿主机/操作系统/模型/思考模式）。
• 在 Project Context 下注入的 Workspace 引导文件。

完整解析见：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 字符）逐文件截断。OpenClaw 还会通过 agents.defaults.bootstrapTotalMaxChars（默认 150000 字符）对所有文件的注入总量设上限。/context 会显示原始大小 vs 注入大小以及是否发生了截断。

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

Skills：注入 vs 按需加载

系统提示包含一份简洁的 Skills 列表（名称 + 说明 + 位置）。这个列表本身也有 token 开销。

Skill 的具体指令默认不注入。模型只在真正需要时才 read 对应 Skill 的 SKILL.md。

工具：两种开销

工具对上下文有两层影响：

1. 系统提示中的工具列表文本（你看到的"Tooling"部分）。
2. 工具 Schema（JSON）。这些 Schema 发给模型用于调用工具，即使你看不到它们，也计入上下文。

/context detail 会列出占用最多的工具 Schema，方便你看清楚谁是"大户"。

命令、指令与"内联快捷方式"

Slash 命令由 Gateway 处理，行为分为几类：

• 独立命令：消息内容仅为 /... 时作为命令执行。
• 指令：/think、/verbose、/reasoning、/elevated、/model、/queue 会在模型看到消息前被剥离。
  • 仅含指令的消息会持久化会话设置。
  • 普通消息中的内联指令作为单次提示生效。
• 内联快捷方式（仅限许可发送者）：普通消息中某些 /... token 可以立即执行（例如"hey /status"），并在剩余文本发给模型前被剥离。

详情见：Slash 命令。

会话、Compaction 与 Pruning（什么会持久化）

跨消息的持久化机制取决于具体方式：

• 普通历史：在会话记录中保留，直到被 Compaction/Pruning 策略处理。
• Compaction：将摘要持久化到记录中，保留最近消息不变。
• Pruning：从当次运行的内存提示中移除旧工具结果，不重写记录文件。

相关文档：Session、Compaction、Session Pruning。

默认情况下，OpenClaw 使用内置的 legacy Context Engine 进行组装和 Compaction。如果你安装了提供 kind: "context-engine" 的插件并通过 plugins.slots.contextEngine 选择，OpenClaw 会将上下文组装、/compact 以及子 Agent 上下文生命周期 hooks 都委托给该引擎。ownsCompaction: false 不会自动回退到 legacy 引擎；活跃引擎必须正确实现 compact()。详见 Context Engine。

/context 实际报告什么

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

• System prompt (run) = 从上一次内嵌（工具能力）运行中捕获，并持久化到会话存储。
• System prompt (estimate) = 无运行报告时（或通过不生成报告的 CLI backend 运行时）即时估算。

两种情况下都会报告大小和主要贡献者；不会完整输出系统提示或工具 Schema 的原始内容。