模块 3 · OpenClaw 文件结构
这套系统的器官：7 个核心文件各司其职
核心问题
- 你说「我要一个文案师」→ 这个文案师靠什么立住？
- 你说「我要它记住用户偏好」→ 这些偏好写在哪？
- 你说「我要它有自己的风格」→ 这个风格怎么固定？
答案：靠文件。 工作区里的 .md 文件不是杂物，而是系统不同的器官。
七大文件速查
| 文件 | 相当于 | 一句话 |
|---|---|---|
SOUL.md | 脾气说明书 | 整体气质入口 |
USER.md | 用户档案 | 长期偏好卡 |
TOOLS.md | 环境小抄 | 本地环境备忘录 |
AGENTS.md | 团队规则手册 | 工作规矩总章 |
MEMORY.md | 长期脑子 | 重要经验总入口 |
daily memory | 当天工作日志 | 现场记录 |
HEARTBEAT.md | 巡检清单 | 心跳巡检说明书 |
逐一详解
1. SOUL.md —— 整体气质
回答这些问题：
- 说话是直接还是绕
- 是温和型还是干练型
- 是先安抚还是先给结果
不只是一句设定词，是气质 + 职责 + 边界一起长出来的。
2. USER.md —— 服务对象
- 用户喜欢什么风格
- 不喜欢什么表达
- 习惯怎么协作
- 哪些偏好要长期记住
3. TOOLS.md —— 本地环境备忘录
- 某个设备叫什么
- 某工具在这台机器上怎么用更顺
- 这台机器上的现实约定
4. AGENTS.md —— 团队规矩总手册
- 先读什么
- 哪些事能自己做
- 哪些事必须先问
- 什么是红线
- 记忆写在哪
5. MEMORY.md —— 长期重要经验总入口
存放：
- 长期规则
- 长期偏好
- 重要经验
- 不该再犯的关键错误
6. 每日 memory 文件 —— 当天现场记录
例：memory/2026-04-06.md
今天发生了什么、踩了什么坑、用户新增了什么要求，先记这里。以后值钱的、稳定的再整理进长期记忆。
7. HEARTBEAT.md —— 心跳巡检说明书
系统平时检查什么、正常怎么回、异常怎么报。
关于「赋予人格」
一个常见偏差
很多人以为赋予人格就是起名字 + 写性格 + 加点设定感。
这只是表面。
真正的赋予人格，是让它成为一个有稳定气质、有职责、有边界、有习惯的人。
而这些东西是靠这些文件一起托起来的：
SOUL.md → 托整体气质
代理设定 → 托岗位身份
USER.md → 托怎么更贴着用户
AGENTS.md → 托边界和规矩
MEMORY.md → 托连续性例子：同样都是「文案师」
❌ 只写一句
「她是一个温柔的文案师」
—— 几乎没用。
✅ 结构化定义
- 她是团队里的文案师
- 她负责：卖点提炼、包装表达、招商文案
- 她说话利落，不绕弯，优先给结果
- 她不负责分镜、不负责画图
- 她接策划内容，往下交给剧本师
- 她长期记得：用户讨厌空话、喜欢直接表达
这时候，这个「人」才真正立起来。
模块总结
核心认知
OpenClaw 不是靠一句提示词活着的。
它是靠不同文件分工协作，慢慢长出来的。
人格不是一句设定，是气质 + 职责 + 边界 + 习惯 + 长期记忆，一起生长出来的。