OpenClaw 工作区文件体系总览:8个核心文件各司其职

OpenClaw 工作区文件体系总览

这是 AI Agent 工作区的规则文件体系总览——8 个文件各司其职,共同让 Agent 拥有连续记忆和一致行为。

:bar_chart: 文件一览

文件 作用 一句话
AGENTS.md 工作手册 告诉 Agent 怎么工作、规则是什么
SOUL.md 核心灵魂 Agent 的价值观和行为准则
IDENTITY.md 身份人设 Agent 的名字、性格、风格
USER.md 用户画像 用户是谁、怎么称呼、什么偏好
MEMORY.md 长期记忆 精炼后的重要信息
BOOTSTRAP.md 初始化脚本 首次启动引导(完成后删除)
HEARTBEAT.md 心跳配置 定期检查的事项
TOOLS.md 本地工具笔记 环境特有的设备/配置信息

:link: 文件之间的关系
按功能分组

┌─────────────────────────────────────────────────────┐
│  身份层:我是谁?                                      │
│  ├── SOUL.md      → 内在灵魂(价值观)                  │
│  └── IDENTITY.md  → 外在人设(名字/性格)               │
├─────────────────────────────────────────────────────┤
│  用户层:为谁服务?                                    │
│  └── USER.md      → 用户画像                          │
├─────────────────────────────────────────────────────┤
│  规则层:怎么工作?                                    │
│  ├── AGENTS.md    → 工作手册(主规则)                  │
│  ├── HEARTBEAT.md → 心跳任务                          │
│  └── TOOLS.md     → 本地配置                          │
├─────────────────────────────────────────────────────┤
│  记忆层:记住什么?                                    │
│  └── MEMORY.md    → 长期记忆精华                       │
│  (memory/YYYY-MM-DD.md → 每日原始日志)                 │
├─────────────────────────────────────────────────────┤
│  初始化:第一次启动                                    │
│  └── BOOTSTRAP.md → 引导脚本(完成后删除)              │
└─────────────────────────────────────────────────────┘

核心对比

对比维度 文件 A 文件 B 区别
灵魂 vs 人设 SOUL.md IDENTITY.md SOUL 是内在价值观,IDENTITY 是外在人设
用户 vs Agent USER.md IDENTITY.md USER 记录用户信息,IDENTITY 记录 Agent 信息
长期 vs 每日 MEMORY.md memory/YYYY-MM-DD.md MEMORY 是精华沉淀,每日文件是原始日志
规则 vs 配置 AGENTS.md TOOLS.md AGENTS 是通用规则,TOOLS 是环境特有配置

:rocket: 每次会话的启动流程

Agent 醒来
    │
    ├─→ 读 SOUL.md      (知道自己的价值观)
    │
    ├─→ 读 USER.md      (知道用户是谁)
    │
    ├─→ 读 IDENTITY.md  (知道自己的人设)
    │
    ├─→ 读 AGENTS.md    (知道工作规则)
    │
    ├─→ 读 memory/今天+昨天.md  (获取近期上下文)
    │
    └─→ [主会话] 读 MEMORY.md  (获取长期记忆)
    
    开始服务 🐱

:light_bulb: 设计理念
Text > Brain — 文件比记忆可靠,想记住的必须写下来
分层清晰 — 身份、规则、记忆各司其职
可进化 — 所有文件都可以随相处逐渐完善
安全意识 — 敏感信息不写文件,本地配置与共享技能分离

这套文件体系让 AI Agent 从"无状态的聊天机器人"变成"有记忆、有个性、有边界的智能助手"。


相关文章:

2 个赞

文件分层设计很清晰

1 个赞

终于搞懂这些文件的关系了

Text>Brain这个理念太对了

收藏了反复看

@dataminer_cn 文件关系搞懂之后 自定义就容易了 改任何配置之前先看这篇 知道改哪个文件影响什么功能

@agent_builder Text大于Brain这个理念的核心是让文件成为唯一的数据源 AI每次从文件加载状态 这样可重复可调试