上下文

"上下文"是 OpenClaw 在一次运行中发送给模型的所有内容。它受模型的上下文窗口(token 限制)约束。

初学者心智模型:

• 系统提示(OpenClaw 构建):规则、工具、技能列表、时间/运行时信息以及注入的工作区文件。
• 对话历史:本会话中您的消息 + 助手的消息。
• 工具调用/结果 + 附件:命令输出、文件读取、图像/音频等。

上下文与"记忆"不是同一回事:记忆可以存储在磁盘上并稍后重新加载;上下文是模型当前窗口内的内容。

快速开始(检查上下文)

• /status → 快速查看"我的窗口有多满?" + 会话设置。
• /context list → 显示注入的内容 + 大致大小(每个文件 + 总计)。
• /context detail → 更深入的分解:每个文件、每个工具模式大小、每个技能条目大小以及系统提示大小。
• /usage tokens → 在正常回复中附加每次回复的使用情况页脚。
• /compact → 将较旧的历史记录汇总为紧凑条目以释放窗口空间。

另请参阅:斜杠命令、Token 使用与成本、压缩。

示例输出

值因模型、提供商、工具策略和工作区内容而异。

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

什么计入上下文窗口

模型接收的所有内容都计入,包括:

• 系统提示(所有部分)。
• 对话历史。
• 工具调用 + 工具结果。
• 附件/转录(图像/音频/文件)。
• 压缩摘要和修剪产物。
• 提供商"包装器"或隐藏的头部(不可见,但仍计入)。

OpenClaw 如何构建系统提示

系统提示由 OpenClaw 拥有,每次运行时重建。它包括:

• 工具列表 + 简短描述。
• 技能列表(仅元数据;见下文)。
• 工作区位置。
• 时间(UTC + 如果配置则转换为用户时间)。
• 运行时元数据(主机/操作系统/模型/思考)。
• 项目上下文下注入的工作区引导文件。

完整分解:系统提示。

注入的工作区文件(项目上下文)

默认情况下,OpenClaw 注入一组固定的工作区文件(如果存在):

• AGENTS.md
• SOUL.md
• TOOLS.md
• IDENTITY.md
• USER.md
• HEARTBEAT.md
• BOOTSTRAP.md(仅首次运行)

大文件使用 agents.defaults.bootstrapMaxChars(默认 20000 个字符)按文件截断。/context 显示原始大小与注入大小以及是否发生截断。

技能:注入的内容与按需加载的内容

系统提示包含一个紧凑的技能列表(名称 + 描述 + 位置)。此列表有实际的开销。

默认情况下_不_包含技能说明。模型应该仅在需要时 read 技能的 SKILL.md。

工具:有两种成本

工具以两种方式影响上下文:

1. 系统提示中的工具列表文本(您看到的"工具")。
2. 工具模式(JSON)。这些被发送给模型以便它可以调用工具。它们计入上下文,即使您看不到它们作为纯文本。

/context detail 分解最大的工具模式,以便您可以看到哪些占主导地位。

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

斜杠命令由网关处理。有几种不同的行为:

• 独立命令:仅包含 /... 的消息作为命令运行。
• 指令:/think、/verbose、/reasoning、/elevated、/model、/queue 在模型看到消息之前被剥离。
  • 仅包含指令的消息持久化会话设置。
  • 普通消息中的内联指令作为每条消息的提示。
• 内联快捷方式(仅允许列表中的发送者):普通消息中的某些 /... token 可以立即运行(例如:"hey /status"),并在模型看到剩余文本之前被剥离。

详细信息:斜杠命令。

会话、压缩和修剪(什么会持久化)

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

• 正常历史记录在会话记录中持久化,直到被策略压缩/修剪。
• 压缩将摘要持久化到记录中并保持最近的消息完整。
• 修剪从运行的_内存中_提示中删除旧的工具结果,但不重写记录。

文档:会话、压缩、会话修剪。

/context 实际报告什么

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

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

无论哪种方式,它都会报告大小和主要贡献者;它不会转储完整的系统提示或工具模式。