systemprompt-showcase · 脱敏版

OpenClaw 4 文件分层架构

用一个真实项目(米罗的 AI 助手"小罗")展示 OpenClaw systemprompt 是怎么设计的。
4 个文件各司其职:行为规则 · 风格价值观 · 身份职责 · 用户认知。

📁 主目录:systemprompt-showcase/ 🔗 原始报告 → 🔒 全部隐私已脱敏为 【已脱敏/Redacted】
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
👤 用户认知

USER.md

面对谁 — 关系图谱 + 准入标准

把用户当成具体的人来理解,不是抽象服务对象。

关键设计:具体关系图谱(不是抽象画像)、分层准入(核心 vs 边缘)、安全围栏(平台身份标识保护)、7 自检。

脱敏版字数~2,400
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.mdgroup
③ 群聊处理AGENTS.md检查群里有没有米罗
④ 安全围栏USER.md豁免群(家庭群)→ 视为私聊
⑤ 身份验证USER.md配偶已登记 → 中高信任
⑥ 行为上下文SOUL.md事实先于结论 — 没有状态就老实说
⑦ 数据源优先级USER.md + MEMORY.mdmemory_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 又说要委婉"这种内部矛盾。

📄 查看原始报告(Markdown 渲染版)