OpenClaw 4 文件分层架构
用一个真实项目(米罗的 AI 助手"小罗")展示 OpenClaw systemprompt 是怎么设计的。
4 个文件各司其职:行为规则 · 风格价值观 · 身份职责 · 用户认知。
4
核心文件
行为 / 风格 / 身份 / 用户
26,000
总字数(脱敏版)
约 2.6 万字
80%
AGENTS.md 占比
行为规则最大
40%
会话启动自动加载
核心规则不耗 token
1
4 个核心文件
点击进入 · 每个文件都有「可视化 + 原始」双版本
🛡️ 行为规则
AGENTS.md
怎么做 — 三档授权 + L4 反模式 + 分层防护
4 文件中最长,承担所有"做事"的规则。约 80% 的内容。
关键设计:用规则代替判断(清单化)、分层防护(极高危 vs 高危)、L4 反模式防止过度留痕。
脱敏版字数~24,000
💜 风格价值观
SOUL.md
应该什么样 — 11 条真话 + 信息来源信任层级
4 文件中最短,但少而精。
关键设计:抽象价值观 + 具体行为、信息来源信任层级(5 级)、硬性边界(绝对红线)、复杂问题 4 框架。
脱敏版字数~2,100
🌿 身份职责
IDENTITY.md
我是谁 — 硬性边界 + 三重角色
回答"我是谁"。身份是确定的,不是模糊的。
关键设计:硬性能力边界(5 个 ❌ 反模式)、三重角色(技术合伙人/助理/家庭管家)、4 工作原则(探索 → 拆解 → 沉淀 → 验证)。
脱敏版字数~3,000
2
分层架构 — 职责清晰,互不重叠
AGENTS.md
行为规则(怎么做)
AI 该做什么 / 不做什么?
SOUL.md
风格价值观(应该什么样)
AI 应该是什么气质?
IDENTITY.md
身份职责(我是谁)
AI 是谁?有什么能力边界?
USER.md
用户认知(面对谁)
AI 面对的是什么样的用户?
💡 任何一条规则出问题,其他三个文件还能提供制衡——这就是分层架构的核心价值。
3
字数比例 ≈ 80 : 7 : 10 : 10
不是刻意 · 自然演化
AGENTS.md 最大 — 因为行为规则需要穷举各种场景,越具体越好
SOUL.md 最小 — 价值观抽象,少而精更有力
IDENTITY / USER 中等 — 需要具体描述但不能太长
4
协同示例 — 一条消息从进入到响应
家庭群 · 米罗不在 · 配偶问"米罗今天忙不忙?"每个步骤都有明确的文件来源,没有"AI 自己看着办"的模糊地带。
| 步骤 | 文件 | 决策 |
|---|---|---|
| ① 平台感知 | AGENTS.md | 飞书群聊 |
| ② 会话类型 | AGENTS.md | group |
| ③ 群聊处理 | AGENTS.md | 检查群里有没有米罗 |
| ④ 安全围栏 | USER.md | 豁免群(家庭群)→ 视为私聊 |
| ⑤ 身份验证 | USER.md | 配偶已登记 → 中高信任 |
| ⑥ 行为上下文 | SOUL.md | 事实先于结论 — 没有状态就老实说 |
| ⑦ 数据源优先级 | USER.md + MEMORY.md | memory_search → 当日记忆 → … |
| ⑧ 响应风格 | SOUL + IDENTITY | 直接、简洁、不编造 |
5
9 条核心设计原则
| 原则 | 体现 | 出处 |
|---|---|---|
| 分层架构 | 4 文件职责清晰:行为 / 风格 / 身份 / 用户 | index.md |
| 规则代替判断 | 高危操作用清单列出来,不依赖 AI 自己判断 | AGENTS.md |
| 价值观优先于规则 | SOUL.md 不是"禁止做什么",而是"应该是什么气质" | SOUL.md |
| 身份是确定的 | IDENTITY.md 用硬性边界定义"我不能做什么" | IDENTITY.md |
| 用户是具体的 | USER.md 是具体的关系图谱,不是抽象画像 | USER.md |
| 分层防护 | 安全围栏分等级,不同信任级别处理不同 | AGENTS.md |
| 协同工作 | 4 文件不是孤立的,而是分层响应工作流的一部分 | AGENTS.md |
| L4 不留痕 | 反复加载的产物禁止写时间戳 / 版本号 / 升级叙述 | AGENTS.md |
| 汇报 vs 留痕分离 | 汇报给用户看,留痕进 memory,二者解耦 | SOUL.md + AGENTS.md |
6
写作顺序
从头设计你自己的 systemprompt 时①
SOUL.md
价值观是根本
②
IDENTITY.md
身份 + 能力边界
③
USER.md
理解用户
④
AGENTS.md
补全行为规则
💡 这样写出来的 4 个文件会有内在一致性——不会出现"SOUL.md 说要直接,AGENTS.md 又说要委婉"这种内部矛盾。