跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

“上下文”是OpenClaw 在一次运行中发送给模型的所有内容。它受模型的上下文窗口（token 限制）约束。 适合初学者的理解模型：
  • 系统提示词（由 OpenClaw 构建）：规则、工具、Skills 列表、时间/运行时信息，以及注入的工作区文件。
  • 对话历史：你在此会话中的消息 + 助手消息。
  • 工具调用/结果 + 附件：命令输出、文件读取、图片/音频等。
上下文 并不等同于 “memory”：memory 可以存储在磁盘上并在之后重新加载；上下文则是模型当前窗口中的内容。

​
快速开始（检查上下文）

  • /status → 快速查看“我的窗口用了多少？”以及会话设置。
  • /context list → 查看注入了什么内容 + 粗略大小（按文件 + 总计）。
  • /context detail → 更深入的明细：每个文件、每个工具 schema 的大小、每个 skill 条目的大小，以及系统提示词大小。
  • /usage tokens → 在普通回复后追加每次回复的用量页脚。
  • /compact → 将较早的历史总结为一条紧凑条目，以释放窗口空间。
另见：斜杠命令、Token 使用与成本、压缩。

​
示例输出

具体数值会因模型、提供商、工具策略以及你的工作区内容而异。

​
/context list

🧠 Context breakdown
Workspace: <workspaceDir>
Bootstrap max/file: 12,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 持有，并会在每次运行时重新构建。它包括：
  • 工具列表 + 简短描述。
  • Skills 列表（仅元数据；见下文）。
  • 工作区位置。
  • 时间（UTC + 如果已配置，则转换后的用户时间）。
  • 运行时元数据（主机/操作系统/模型/思考模式）。
  • Project Context 下被注入的工作区 bootstrap 文件。
完整明细见：System Prompt。

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

默认情况下，OpenClaw 会注入一组固定的工作区文件（如果存在）：
  • AGENTS.md
  • SOUL.md
  • TOOLS.md
  • IDENTITY.md
  • USER.md
  • HEARTBEAT.md
  • BOOTSTRAP.md（仅首次运行）
大文件会按文件使用 agents.defaults.bootstrapMaxChars（默认 12000 个字符）进行截断。OpenClaw 还会通过 agents.defaults.bootstrapTotalMaxChars（默认 60000 个字符）对所有文件的 bootstrap 注入总量施加上限。/context 会显示原始大小与注入后大小，以及是否发生了截断。 发生截断时，运行时可以在 Project Context 下方注入一段提示词内警告块。可通过 agents.defaults.bootstrapPromptTruncationWarning 进行配置（off、once、always；默认 once）。

​
Skills：预注入与按需加载

系统提示词中包含一个精简的 Skills 列表（名称 + 描述 + 位置）。这个列表会带来真实的开销。 默认情况下不会包含 skill 指令本身。模型应仅在需要时才 read 该 skill 的 SKILL.md。

​
Tools：有两种成本

工具会通过两种方式影响上下文：
  1. 系统提示词中的工具列表文本（也就是你看到的 “Tooling”）。
  2. 工具 schemas（JSON）。这些内容会发送给模型，以便它调用工具。即使你看不到它们的纯文本形式，它们仍然会计入上下文。
/context detail 会拆解占用最大的工具 schema，这样你就能看出主要开销来自哪里。

​
Commands、directives 和 “inline shortcuts”

斜杠命令由 Gateway 网关处理。这里有几种不同的行为：
  • 独立命令：如果一条消息只有 /...，它会作为命令运行。
  • Directives：/think、/verbose、/trace、/reasoning、/elevated、/model、/queue 会在模型看到消息前被剥离。
    • 仅包含 directive 的消息会持久化会话设置。
    • 普通消息中的内联 directive 会作为单条消息级别的提示。
  • Inline shortcuts（仅 allowlisted 发送者）：普通消息中的某些 /... token 可以立即运行（例如：“hey /status”），并会在模型看到剩余文本前被剥离。
详情见：斜杠命令。

​
会话、压缩和裁剪（哪些会持久化）

哪些内容会在消息之间保留，取决于所使用的机制：
  • 普通历史 会保留在会话转录中，直到按策略被压缩/裁剪。
  • 压缩 会将摘要持久化到转录中，同时保留最近的消息不变。
  • 裁剪 会从内存中的提示词里移除旧的工具结果，以释放上下文窗口空间，但不会重写会话转录 —— 完整历史仍可在磁盘上检查。
文档：会话、压缩、会话裁剪。 默认情况下，OpenClaw 使用内置的 legacy 上下文引擎来进行组装和 压缩。如果你安装了一个提供 kind: "context-engine" 的插件，并 通过 plugins.slots.contextEngine 选择它，OpenClaw 就会将上下文 组装、/compact 以及相关的子智能体上下文生命周期钩子委托给该 引擎。ownsCompaction: false 不会自动回退到 legacy 引擎；当前激活的引擎仍必须正确实现 compact()。完整的 可插拔接口、生命周期钩子和配置请参见 Context Engine。

​
/context 实际报告了什么

在可用时，/context 会优先使用最新的基于运行构建的系统提示词报告：
  • System prompt (run) = 从上一次嵌入式（支持工具）运行中捕获，并持久化到会话存储中的报告。
  • System prompt (estimate) = 当没有运行报告可用时即时计算（或者在使用不会生成该报告的 CLI 后端运行时计算）。
无论哪种方式，它都会报告大小和主要贡献项；它不会转储完整的系统提示词或工具 schema。

​
相关内容