🐙 OpenClaw

OpenClaw 系统提示词教程

OpenClaw 会为每一次智能体运行独立构建专属系统提示词，全程不沿用 pi-coding-agent 的默认提示词，由系统动态组装并注入执行流程，是智能体理解规则、调用工具、保持行为一致的核心指令依据。本文基于官方规范，完整讲解系统提示词的结构、模式、注入机制与调试方法。

一、概述

系统提示词是 OpenClaw 智能体的基础行为手册，采用紧凑模块化设计，在每次智能体启动时自动生成。提示词内的安全规则为指导性约束，实际执行的硬限制需通过工具策略、执行审批、沙箱隔离、渠道白名单实现。

二、系统提示词标准结构

OpenClaw 系统提示词由固定模块按需拼接，确保精简且信息完整：

Tooling（工具集）
展示当前可用工具清单与简要描述，明确工具调用规则。
Safety（安全防护）
基础行为约束，提醒智能体避免越权操作与绕过监督的行为。
Skills（技能）
存在可用技能时注入，告知模型按需读取技能文件；无技能则省略该模块。
OpenClaw Self-Update（自更新）
说明 config.apply 与 update.run 的使用方式，支持智能体自我更新。
Workspace（工作区）
声明智能体唯一工作目录 agents.defaults.workspace，限定文件操作范围。
Documentation（文档）
指向本地 OpenClaw 文档路径，指导模型优先查阅文档了解系统规则。
Workspace Files (injected)（工作区文件注入）
标记后续将注入引导文件，让模型直接获取身份与配置上下文。
Sandbox（沙箱）
启用沙箱时，说明隔离规则、运行路径与提权权限，明确安全边界。
Current Date & Time（当前时间）
包含用户时区信息，保持提示词缓存稳定。
Reply Tags（回复标签）
声明适配对应模型提供商的回复标签语法，规范输出格式。
Heartbeats（心跳）
定义心跳指令与确认行为，维持会话活性。
Runtime（运行时）
单行展示主机、系统、Node 版本、模型、思考级别等运行环境信息。
Reasoning（推理）
说明推理内容可见性与 /reasoning 切换规则，控制推理过程展示。

三、提示词模式（promptMode）

运行时会自动为智能体分配提示词模式，分为三类：

full（默认）
适用于主智能体，包含全部模块，功能与上下文最完整。
minimal
适用于子智能体，省略技能、记忆、自更新、回复标签等非核心模块，仅保留工具、安全、工作区、沙箱、时间、运行时与基础上下文。
none
极简模式，仅保留基础身份行，无额外上下文信息。

使用 minimal 模式时，额外注入的提示词会标记为子智能体上下文，与主智能体的群组聊天上下文区分。

四、工作区引导文件注入

系统会自动修剪并注入工作区引导文件，作为智能体的核心身份与配置依据：

注入文件列表：AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md、BOOTSTRAP.md（仅全新工作区）。
截断规则：大文件自动截断并添加标记，单文件最大长度由 agents.defaults.bootstrapMaxChars 控制（默认 20000 字符）。
缺失处理：文件缺失时注入简短缺失标记，不中断提示词组装。
自定义拦截：可通过 agent:bootstrap 内部钩子，修改或替换注入的引导文件。

五、时间与时区配置

时间相关信息仅注入时区，保证提示词缓存稳定，配置方式：

{
  "agents": {
    "defaults": {
      "userTimezone": "Asia/Shanghai",
      "timeFormat": "24"
    }
  }
}

userTimezone：设置用户时区，固定注入提示词。
timeFormat：可选 auto/12/24，规范时间展示格式。
智能体获取精确时间需调用 session_status，状态卡片会包含时间戳。

六、Skills 技能注入机制

技能模块采用轻量注入设计，避免提示词体积膨胀：

<available_skills>
  <skill>
    <name>文件处理</name>
    <description>读写与编辑本地文件</description>
    <location>workspace/skills</location>
  </skill>
</available_skills>

仅注入技能名称、描述、路径，不加载完整技能内容。
模型按需通过 read 指令读取对应 SKILL.md 文件，平衡提示词大小与功能可用性。

七、文档引用规范

提示词会包含 OpenClaw 本地文档指引：

文档路径：工作区 docs/ 目录或 npm 包内置文档。
查阅规则：模型优先自主查阅本地文档，无法访问时再询问用户。
附加资源：提供源码仓库、社区、ClawHub 等技能发现渠道。

八、上下文调试命令

可通过指令实时查看提示词注入详情，快速排查上下文问题：

/context list：查看各注入文件的贡献大小。
/context detail：查看原始内容、注入内容、截断情况与工具 schema 开销。

九、最佳实践

控制引导文件大小，单文件尽量不超过 15000 字符，避免提示词溢出。
子智能体强制使用 minimal 模式，减少上下文消耗，提升响应速度。
区分指导性约束与硬限制，提示词仅做行为指导，安全管控依赖沙箱与权限配置。
修改提示词相关配置后，用 /context detail 验证生效状态。
仅注入必要技能，保持基础提示词轻量化，减少冗余信息占用上下文。

返回列表