上下?

“上下??* OpenClaw 发送给模型进行运行的所有内?。它受模型的**上下文窗?(token 限制)约束?

初学者心智模型:

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

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

快速开始(检查上下文?

  • /status ?快?我的窗口有多满?“视图 + 会话设置?
  • /context list ?注入的内?+ 粗略大小(每个文?+ 总计)?
  • /context detail ?更深层的分解:每个文件、每个工具模式大小、每个技能条目大小,以及系统提示大小?
  • /usage tokens ?将每个回复的使用页脚附加到正常回复?
  • /compact ?将旧历史摘要成紧凑条目以释放窗口空间?

另见:斜杠命令Token 使用和成本压缩?

示例输出

值因模型、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)

什么算入上下文窗口

模型收到的所有内容都算,包括?

  • 系统提示(所有部分)?
  • 对话历史?
  • 工具调用 + 工具结果?
  • 附件/记录(图?音频/文件)?
  • 压缩摘要和修剪产物?
  • Provider”包装?或隐藏标头(不可见,仍然计入)?

OpenClaw 如何构建系统提示

系统提示?OpenClaw 拥有的,并在每次运行中重建。它包括?

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

完整分解:系统提示?

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

默认情况下,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 注入大小以及是否发生了截断?

技能:什么被注入 vs 按需加载

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

默认情况?*不包?*技能指令。模型被期望在需要时 read 技能的 SKILL.md?

工具:有两种成本

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

  1. 系统提示中的工具列表文本(你看到?工具”部分)?
  2. 工具模式(JSON)。这些被发送给模型以便它可以调用工具。它们算入上下文,尽管你看不到它们作为纯文本?

/context detail 分解最大的工具模式,以便你可以看到什么占主导?

命令、指令和”内联快捷?

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

  • 独立命令:仅?/... 的消息作为命令运行?
  • 指令/think/verbose/reasoning/elevated/model/queue 在模型看到消息之前被剥离?
    • 仅指令消息持久化会话设置?
    • 正常消息中的内联指令作为每消息提示?
  • **内联快捷?*(仅白名单发送者):某些普通消息中?/... 令牌可以立即运行(例?“hey /status”),并在模型看到剩余文本之前被剥离?

详情:斜杠命令?

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

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

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

文档:会话压缩会话修剪?

/context 实际报告什?

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

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

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