OpenClaw 系统提示设计

Overview

OpenClaw 为每次 agent 运行构建自定义系统提示，通过七个引导文件注入。本文梳理文件职责划分、设计原则和常见陷阱。

为什么重要

OpenClaw 的”七引导文件”系统提示设计，是开源 Agent 框架里少见的把分层提示工程做成产品的实践。理解它的职责划分和常见陷阱，能直接复用到自研 Agent：哪些规则放 base、哪些放 turn、哪些放 skill 触发上下文。这套结构本质是一份可复制的 Agent 系统提示工程蓝图。

为什么重要

OpenClaw 的”七引导文件”系统提示设计，是开源 Agent 框架里少见的把分层提示工程做成产品的实践。理解它的职责划分和常见陷阱，能直接复用到自研 Agent：哪些规则放 base、哪些放 turn、哪些放 skill 触发上下文。这套结构本质是一份可复制的 Agent 系统提示工程蓝图。

七个引导文件职责

文件	职责	关键原则
AGENTS.md	操作规则手册	”简洁的员工手册，而不是小说”
SOUL.md	个性定义	个性变更频率远低于操作规则
USER.md	用户信息	”永远保持简洁”——行为规则归 AGENTS.md
IDENTITY.md	极简身份元数据	”三到五行”就足够
TOOLS.md	环境速查表	”API 基础 URL 是工具说明；‘始终使用此 API’ 是规则（归 AGENTS.md）“
MEMORY.md	学到的模式	”学到的模式，而非重申的规则”
HEARTBEAT.md	周期性任务清单	保持为检查列表

关键事实

• 子代理仅注入 AGENTS.md + TOOLS.md
• 每文件最大 20,000 字符，总 bootstrap 上限 60,000 字符
• 提示模式：full（所有章节）/ minimal（子代理）/ none（仅身份行）

五项设计原则

1. 单一职责：每文件只负责一件事
2. 禁止重复：一条规则只在一个文件中出现
3. 可执行性测试：硬性限制放在配置和工具策略中
4. 简洁优于愿景：删除不会改变行为的句子
5. 定期修剪：MEMORY.md 每周，AGENTS.md 每月

”泥球”反模式

最常见的陷阱：AGENTS.md 变成”一切内容的倾倒场”。一个膨胀的 AGENTS.md 可能 25,000 字符，清理后七个文件总计仅约 19,200 字符。

安全红线设计要点（来自 sanwan.ai）

• 好红线：具体可操作（如”Never 输出手机号、身份证号”）
• 坏红线：模糊难执行（如”注意保护用户隐私”）
• 信息披露三问：信息从哪来？外人知道有风险？拿不准？
• 紧急情况：“紧急”不是绕过红线的理由

故障定位

症状	修复文件
语气/个性不对	SOUL.md
忽略规则/路由	AGENTS.md
API 端点错误	TOOLS.md
忘记学到的模式	MEMORY.md

See Also

• Agent 开发综合指南 — Agent 开发完整框架
• AGENTS.md 格式规范 — AGENTS.md 开放格式标准