当前位置：首页 > news >正文

OpenClaw从入门到应用——Agent：上下文（Context）

news 2026/4/23 19:52:09

通过OpenClaw实现副业收入：《OpenClaw赚钱实录：从“养龙虾“到可持续变现的实践指南》

上下文是OpenClaw 在每次运行中发送给模型的所有内容。它受到模型上下文窗口（令牌限制）的约束。

初学者心智模型：

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

上下文与“记忆”不同：记忆可以存储在磁盘上并在以后重新加载；而上下文是当前位于模型窗口内的内容。

快速开始（检查上下文）

/status→ 快速查看“我的窗口有多满？”视图 + 会话设置。
/context list→ 列出了注入的内容及其大致大小（每个文件的大小及总大小）。
/context detail→ 更详细的细分：每个文件、每个工具架构、每个技能条目以及系统提示的大小。
/usage tokens→ 在正常回复后附加每次回复的令牌使用情况页脚。
/compact→ 将较旧的历史记录总结为一个紧凑的条目，以释放窗口空间。

另请参阅：斜杠命令，令牌使用与成本，压缩。

输出示例

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

`/context list`

🧠 上下文细分 工作区： Bootstrap 最大/文件：20,000 字符 沙盒模式：mode=non-main sandboxed=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 令牌） 工具架构（JSON）：31,988 字符（~7,997 令牌）（计入上下文；未显示为文本） 工具：（同上） 会话令牌（缓存）：总计 14，250 / 上下文 32,000

`/context detail`

🧠 上下文细分（详细） … 顶级技能（提示条目大小）： - frontend-design：412 字符（~103 令牌） - oracle：401 字符（~101 令牌） …（还有 10 个技能） 顶级工具（架构大小）： - 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文件。

工具：存在两种成本

工具在两个方面影响上下文：

系统提示中的工具列表文本（你看到的“工具”部分）。
工具架构（JSON）。这些被发送给模型，以便它可以调用工具。即使你没有看到它们作为纯文本，它们也会计入上下文。
/context detail细分了最大的工具架构，以便你了解哪些占主导地位。

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

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

独立命令：仅包含/...的消息将作为命令运行。
指令：/think,/verbose,/reasoning,/elevated,/model,/queue在模型看到消息之前会被剥离。
- 仅包含指令的消息会持久化会话设置。
- 正常消息中的内联指令作为每条消息的提示。
内联快捷方式（仅限允许列表中的发送者）：正常消息中的某些/...令牌可以立即运行（例如：“嘿 /status”），并在模型看到剩余文本之前被剥离。

详细信息：斜杠命令。

会话、压缩和修剪（哪些是持久化的）

消息之间持久化的内容取决于机制：

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

文档：会话，压缩，会话修剪。

默认情况下，OpenClaw 使用内置的legacy上下文引擎进行组装和压缩。如果你安装了一个提供kind: “context-engine”的插件，并通过plugins.slots.contextEngine选择它，OpenClaw 会将上下文组装、/compact以及相关的子代理上下文生命周期钩子委托给该引擎。