System Prompt（系统提示）

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

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

结构

提示有意紧凑并使用固定部分：

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

提示模式

OpenClaw 可以为子代理渲染更小的系统提示。运行时为每次运行设置 promptMode（不是面向用户的配置）：

  • full（默认）：包括上述所有部分。
  • minimal：用于子代理；省略 Skills、Memory Recall、OpenClaw Self-Update、Model Aliases、User Identity、Reply Tags、Messaging、Silent Replies 和 Heartbeats。Tooling、Workspace、Sandbox、Current Date & Time（已知时）、Runtime 和注入的上下文保持可用。
  • none：仅返回基本身份行。

当 promptMode=minimal 时，额外注入的提示被标记为 Subagent Context 而不是 Group Chat Context。

工作区引导注入

引导文件被修剪并附加在 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。查看 Context。

时间处理

当已知用户时区时，系统提示包含专用的 Current Date & Time 部分。为了保持提示缓存稳定，现在它只包含时区（无动态时钟或时间格式）。

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

配置：

  • agents.defaults.userTimezone
  • agents.defaults.timeFormat（auto | 12 | 24）

查看 Date & Time 了解完整行为详情。

技能

当存在符合条件的技能时，OpenClaw 注入紧凑的可用技能列表（formatSkillsForPrompt），其中包括每个技能的文件路径。提示指示模型使用 read 加载列出位置（工作区、托管或捆绑）的 SKILL.md。如果没有符合条件的技能，则省略 Skills 部分。

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

这使基本提示保持小巧，同时仍能启用有针对性的技能使用。

文档

可用时，系统提示包含 Documentation 部分，指向本地 OpenClaw 文档目录（仓库工作区中的 docs/ 或捆绑的 npm 包文档），还注明公共镜像、源仓库、社区 Discord 和 ClawdHub (https://clawdhub.com) 用于技能发现。提示指示模型首先咨询本地文档了解 OpenClaw 行为、命令、配置或架构，并在可能时自己运行 openclaw status（仅在缺少访问权限时询问用户）。

← 返回文档首页