Skip to main content

​
上下文

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

​
快速入门（检查上下文）

  • /status → 快速查看“我的窗口使用了多少？”以及会话设置。
  • /context list → 显示注入内容 + 粗略大小（每个文件 + 总计）。
  • /context detail → 更深入的细节：每个文件、每个工具 schema 大小，每个技能条目大小，以及系统提示大小。
  • /usage tokens → 在普通回复尾部附加每次回答的令牌使用情况。
  • /compact → 将较旧的历史总结为紧凑条目以释放窗口空间。
另见：斜杠命令、令牌使用 & 费用、压缩。

​
示例输出

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

​
/context list

🧠 上下文分解
工作区：<workspaceDir>
引导最大/文件：20,000 字符
沙箱：模式=非主，沙箱化=false
系统提示（运行时）：38,412 字符（约9,603 令牌）（项目上下文 23,901 字符（约5,976 令牌））

注入的工作区文件：
- AGENTS.md：正常 | 原始 1,742 字符（约436 令牌）| 注入 1,742 字符（约436 令牌）
- SOUL.md：正常 | 原始 912 字符（约228 令牌） | 注入 912 字符（约228 令牌）
- TOOLS.md：已截断 | 原始 54,210 字符（约13,553 令牌）| 注入 20,962 字符（约5,241 令牌）
- IDENTITY.md：正常 | 原始 211 字符（约53 令牌） | 注入 211 字符（约53 令牌）
- USER.md：正常 | 原始 388 字符（约97 令牌） | 注入 388 字符（约97 令牌）
- HEARTBEAT.md：缺失 | 原始 0 | 注入 0
- BOOTSTRAP.md：正常 | 原始 0 字符（约0 令牌） | 注入 0 字符（约0 令牌）

技能列表（系统提示文本）：2,184 字符（约546 令牌）（12 个技能）
工具：read、edit、write、exec、process、browser、message、sessions_send、…
工具列表（系统提示文本）：1,032 字符（约258 令牌）
工具 schema（JSON）：31,988 字符（约7,997 令牌）（计入上下文；文本不展示）
工具：（同上）

会话令牌（缓存）：14,250 总计 / ctx=32,000

​
/context detail

🧠 上下文分解（详细）
…
顶级技能（提示条目大小）：
- frontend-design：412 字符（约103 令牌）
- oracle：401 字符（约101 令牌）
… （还剩 10 个技能）

顶级工具（schema 大小）：
- browser：9,812 字符（约2,453 令牌）
- exec：6,240 字符（约1,560 令牌）
… （还剩 N 个工具）

​
什么计算在上下文窗口内

模型接收到的所有内容都会被计入，包括：
  • 系统提示（所有部分）。
  • 对话历史。
  • 工具调用 + 工具结果。
  • 附件/转录内容（图片/音频/文件）。
  • 压缩摘要与修剪产物。
  • 提供商“包装”或隐藏头信息（不可见但计数在内）。

​
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 会显示 原始与注入 大小，以及是否发生了截断。 截断时，运行时可在项目上下文下注入一个提示警告块。通过 agents.defaults.bootstrapPromptTruncationWarning 配置（off、once、always，默认 once）。

​
技能：注入内容与按需加载

系统提示包含一个紧凑的 技能列表（名称 + 描述 + 位置），这张列表有真实的开销。 技能说明默认 不 被包含。模型预计只有在需要时才 read 技能的 SKILL.md。

​
工具：两种开销

工具对上下文影响两方面：
  1. 系统提示中的 工具列表文本（即你看到的“工具”部分）。
  2. 工具 schema（JSON）。这些被发送给模型以便其调用工具。它们计入上下文，即使你看不到文本形式。
/context detail 会分解最大的工具 schema，帮你看清主要开销来源。

​
命令、指令与“内联快捷方式”

斜杠命令由 Gateway 处理。有几种不同行为：
  • 独立命令：只有 /... 的消息作为命令执行。
  • 指令：如 /think、/verbose、/reasoning、/elevated、/model、/queue 会在模型看到消息前被剥离。
    • 只有指令的消息会持久化会话设置。
    • 正常消息中的内联指令作为单条消息提示。
  • 内联快捷方式（仅白名单发送者）：正常消息中的某些 /... 令牌可立即运行（示例：“hey /status”），且在模型看到剩余文本前被剥离。
详情见：斜杠命令。

​
会话、压缩与修剪（持久化内容）

跨消息持久化取决于机制：
  • 正常历史 会保存在会话记录中，直到被政策压缩或修剪。
  • 压缩 将一段摘要持久化到记录，同时保留近期消息完整。
  • 修剪 仅从 内存 提示中移除旧的工具结果，不会重写会话记录。
文档： 会话、压缩、会话修剪。 默认情况下，OpenClaw 使用内置的 legacy 上下文引擎来进行组装和压缩。如果你安装了提供 kind: "context-engine" 的插件并通过 plugins.slots.contextEngine 选择它，OpenClaw 会将上下文组装、/compact 以及相关的子代理上下文生命周期钩子委托给该引擎。

​
/context 实际报告什么

/context 优先显示最新的 运行时构建 系统提示报告（如果存在）：
  • 系统提示（运行） = 来自最后一次内嵌（具备工具功能）运行并持久化于会话存储的快照。
  • 系统提示（估计） = 在无运行报告时实时计算（或通过不生成报告的 CLI 后端运行时）。
无论哪种方式，它都会报告大小和主要贡献项，但不会完整输出系统提示或工具 schema。