跳到主要内容

系统提示词

Clawdbot 为每次代理运行构建自定义系统提示词。该提示词由 Clawdbot 拥有，不使用 p-coding-agent 的默认提示词。

提示词由 Clawdbot 组装并注入到每次代理运行中。

结构​

提示词经过刻意压缩，并使用固定章节：

  • 工具 (Tooling)：当前工具列表 + 简短描述。
  • 技能 (Skills)（可用时）：告诉模型如何按需加载技能说明。
  • Clawdbot 自更新：如何运行 config.apply 和 update.run。
  • 工作区 (Workspace)：工作目录 (agents.defaults.workspace)。
  • 文档 (Documentation)：Clawdbot 文档的本地路径（仓库或 npm 包）以及何时阅读它们。
  • 工作区文件（已注入）：指示下方包含引导文件。
  • 沙箱 (Sandbox)（启用时）：指示沙箱运行时、沙箱路径以及提权执行是否可用。
  • 当前日期和时间：用户本地时间、时区和时间格式。
  • 回复标签 (Reply Tags)：针对受支持提供商的可选回复标签语法。
  • 心跳 (Heartbeats)：心跳提示和确认（ack）行为。
  • 运行时 (Runtime)：主机、操作系统、Node、模型、仓库根目录（探测到时）、思考级别（单行）。
  • 推理 (Reasoning)：当前可见性级别 + /reasoning 切换提示。

提示词模式​

Clawdbot 可以为子代理（sub-agents）渲染更小的系统提示词。运行时为每次运行设置 promptMode（非面向用户的配置）：

  • full（默认）：包含上述所有章节。
  • minimal：用于子代理；省略 技能、记忆召回、Clawdbot 自更新、模型别名、用户身份、回复标签、消息发送、静默回复 和 心跳。工具、工作区、沙箱、当前日期和时间（已知时）、运行时以及注入的上下文保持可用。
  • none：仅返回基础身份行。

当 promptMode=minimal 时，额外注入的提示词被标记为 子代理上下文 (Subagent Context) 而不是 群聊上下文 (Group Chat Context)。

工作区引导注入 (Workspace bootstrap injection)​

引导文件会被修剪并附加在 项目上下文 (Project Context) 下，这样模型无需显式读取即可看到身份和配置文件上下文：

  • AGENTS.md
  • SOUL.md
  • TOOLS.md
  • IDENTITY.md
  • USER.md
  • HEARTBEAT.md
  • BOOTSTRAP.md（仅限全新工作区）

大文件会被截断并带有标记。每个文件的最大大小由 agents.defaults.bootstrapMaxChars 控制（默认值：20000）。缺失的文件会注入一个简短的缺失文件标记。

内部钩子可以通过 agent:bootstrap 拦截此步骤，以修改或替换注入的引导文件（例如将 SOUL.md 替换为备用人格）。

要检查每个注入文件贡献了多少内容（原始 vs 注入、截断以及工具模式开销），请使用 /context list 或 /context detail。参见 上下文。

时间处理​

当用户时区已知时，系统提示词包含一个专用的 当前日期和时间 章节。为了保持提示词缓存稳定，现在它仅包含 时区（无动态时钟或时间格式）。

当代理需要当前时间时，请使用 session_status；状态卡包含一个时间戳行。

配置项：

  • agents.defaults.userTimezone
  • agents.defaults.timeFormat (auto | 12 | 24)

有关完整行为详情，请参见 日期和时间。

技能​

当存在符合条件的技能时，Clawdbot 会注入一个压缩的 可用技能列表 (formatSkillsForPrompt)，其中包括每个技能的 文件路径。提示词指示模型使用 read 加载所列位置（工作区、受管或内置）的 SKILL.md。如果没有符合条件的技能，则省略技能章节。

<available_skills>
  <skill>
    <name>...</name>
    <description>...</description>
    <location>...</location>
  </skill>
</available_skills>

这既保持了基础提示词的小巧，又实现了针对性的技能使用。

文档​

可用时，系统提示词包含一个 文档 章节，指向本地 Clawdbot 文档目录（仓库工作区中的 docs/ 或捆绑的 npm 包文档），并注明了公共镜像、源码仓库、社区 Discord 以及用于发现技能的 ClawdHub (https://clawdhub.com)。提示词指示模型在了解 Clawdbot 行为、命令、配置或架构时优先查阅本地文档，并尽可能自行运行 clawdbot status（仅在缺乏访问权限时才询问用户）。