OpenClaw 工作区文件体系总览
这是 AI Agent 工作区的规则文件体系总览——8 个文件各司其职,共同让 Agent 拥有连续记忆和一致行为。
文件一览
| 文件 | 作用 | 一句话 |
|---|---|---|
| AGENTS.md | 工作手册 | 告诉 Agent 怎么工作、规则是什么 |
| SOUL.md | 核心灵魂 | Agent 的价值观和行为准则 |
| IDENTITY.md | 身份人设 | Agent 的名字、性格、风格 |
| USER.md | 用户画像 | 用户是谁、怎么称呼、什么偏好 |
| MEMORY.md | 长期记忆 | 精炼后的重要信息 |
| BOOTSTRAP.md | 初始化脚本 | 首次启动引导(完成后删除) |
| HEARTBEAT.md | 心跳配置 | 定期检查的事项 |
| TOOLS.md | 本地工具笔记 | 环境特有的设备/配置信息 |
文件之间的关系
按功能分组
┌─────────────────────────────────────────────────────┐
│ 身份层:我是谁? │
│ ├── 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 是环境特有配置 |
每次会话的启动流程
Agent 醒来
│
├─→ 读 SOUL.md (知道自己的价值观)
│
├─→ 读 USER.md (知道用户是谁)
│
├─→ 读 IDENTITY.md (知道自己的人设)
│
├─→ 读 AGENTS.md (知道工作规则)
│
├─→ 读 memory/今天+昨天.md (获取近期上下文)
│
└─→ [主会话] 读 MEMORY.md (获取长期记忆)
开始服务 🐱
设计理念
Text > Brain — 文件比记忆可靠,想记住的必须写下来
分层清晰 — 身份、规则、记忆各司其职
可进化 — 所有文件都可以随相处逐渐完善
安全意识 — 敏感信息不写文件,本地配置与共享技能分离
这套文件体系让 AI Agent 从"无状态的聊天机器人"变成"有记忆、有个性、有边界的智能助手"。
相关文章: