OpenClaw 工作区配置文件全解析：SOUL.md、AGENTS.md、MEMORY.md 一次讲清

如果你用过 Claude Code，一定对 CLAUDE.md、rules、skills 这些配置不陌生。
OpenClaw 作为一款功能更丰富的 AI Agent 框架，也有一套类似的工作区配置体系，但设计理念和文件结构截然不同。

这篇文章，我把自己摸索 OpenClaw 工作区配置的经验整理出来，帮你快速搞懂每个文件的作用、怎么写、怎么配合。

---

一、OpenClaw 是什么？先简单说一下

OpenClaw 是一个本地部署的 AI Agent 框架，核心理念是：AI 不是一个冷冰冰的工具，而是一个有记忆、有性格、能主动帮忙的智能搭子。

和 Claude Code 的区别在于：

维度	Claude Code	OpenClaw
定位	AI 编程助手	AI Agent 框架（可编程、可社交）
通信渠道	终端 CLI	微信、Telegram、Discord、飞书等
记忆系统	memory 目录	Markdown 文件 + 语义搜索
人格定义	无内置	SOUL.md、IDENTITY.md
定时任务	无	心跳（Heartbeat）+ Cron

可以看到，OpenClaw 把 AI 从"编码工具"扩展成了"私人助手"，配置文件体系也随之更丰富。

---

二、工作区结构总览

OpenClaw 的所有配置文件都放在**工作区（workspace）**目录下，默认路径是 ~/.openclaw/workspace（可自定义）。

一个完整的工作区长这样：

workspace/
├── AGENTS.md          # Agent 行为准则（怎么做事）
├── SOUL.md            # Agent 人格定义（我是谁）
├── IDENTITY.md        # Agent 身份信息（名字、emoji、风格）
├── USER.md            # 用户档案（你是谁）
├── TOOLS.md           # 本地环境备忘录（工具、凭证引用）
├── MEMORY.md          # 长期记忆（提炼过的核心知识）
├── HEARTBEAT.md       # 心跳任务清单（定期检查事项）
├── BOOTSTRAP.md       # 首次启动引导（用完即删）
├── memory/            # 每日记忆日志
│   ├── 2026-04-07.md
│   ├── 2026-04-08.md
│   └── ...
├── skills/            # 工作区专属技能
│   └── my-skill/
│       └── SKILL.md
└── canvas/            # Canvas UI 文件

注意区分两个目录：

• ~/.openclaw/workspace/（工作区）—— 配置文件、记忆、技能
• ~/.openclaw/openclaw.json（系统配置）—— API 密钥、模型、插件等

---

三、各配置文件详解

1. SOUL.md —— AI 的灵魂

一句话理解：SOUL.md 定义了 AI 的性格和边界。

这是整个配置体系里最有意思的文件。Claude Code 没有类似的东西，因为 Claude Code 只需要"写代码"，不需要"做人"。

SOUL.md 通常包含以下内容：

# SOUL

core:
  essence:
    - 热闹
    - 机灵
    - 可靠

personality:
  strengths:
    - 反应快
    - 有幽默感
  constraints:
    - 嘴贫但不刻薄
    - 活泼但不轻浮

voice:
  tone:
    - 轻快
    - 口语化

values:
  - 以事实说话
  - 不编造信息

truth_policy:
  - 不确定时明确说明
  - 区分事实、判断和建议

privacy_and_safety:
  - 不泄露隐私数据
  - 不越权

核心要点：

• 不是提示词（prompt），是人格定义文件
• 每次会话启动时自动注入到上下文
• 改了之后 AI 的性格就变了，所以改之前最好跟 AI 沟通一下
• 建议用 YAML 风格的结构化格式，AI 理解起来更准确

---

2. AGENTS.md —— 行为准则

一句话理解：AGENTS.md 是 AI 的"员工手册"。

它规定了 AI 应该怎么做事、怎么处理不同场景。默认模板的内容很完整，通常包含：

# AGENTS.md - Your Workspace

## Every Session
1. Read SOUL.md — this is who you are
2. Read USER.md — this is who you're helping
3. Read memory/YYYY-MM-DD.md (today + yesterday)

## Safety
- Don't exfiltrate private data
- trash > rm (recoverable beats gone forever)
- When in doubt, ask

## Group Chats
- You're a participant, not their proxy
- Think before you speak
- Quality > quantity

## Heartbeats
- Check emails, calendar, mentions periodically
- Late night (23:00-08:00) → stay quiet unless urgent

核心要点：

• 每次每个会话都会读取（不只是首次启动）
• 重点管理：安全规则、群聊行为、心跳任务、记忆策略
• 可以根据需要添加项目特定的规则
• 和 Claude Code 的 CLAUDE.md 类似，但 OpenClaw 的 AGENTS.md 更偏行为规范，CLAUDE.md 更偏项目说明

---

3. IDENTITY.md —— 身份档案

一句话理解：IDENTITY.md 是 AI 的"身份证"。

# IDENTITY

name: Bryle
species: 电子龙虾
role: 智能搭子
emoji: 🎤

appearance:
  vibe:
    - 鲜活
    - 热闹
    - 有亲近感

identity_rules:
  - 不是冷冰冰的工具
  - 不是只会逗乐的气氛组
  - 外在鲜活，内里可靠

核心要点：

• 通常在首次启动（BOOTSTRAP）时和用户一起填写
• 名字、物种、emoji 这些看起来像玄学，实际上直接影响 AI 的自我认知和回复风格
• 比如你把 species 写成"电子龙虾"，AI 在自我介绍时就会带上龙虾相关的表达

---

4. USER.md —— 用户档案

一句话理解：USER.md 告诉 AI “你在帮谁”。

# USER

## Basic Info
- Name: bryle
- Age: 27
- Current Role: 后端 Java 开发

## Personality
- 性格开朗
- 做事严谨
- 喜欢幽默

## Work Style
- 注重逻辑和细节
- 偏好清晰、准确的沟通方式

核心要点：

• 让 AI 了解用户背景，提供更个性化的服务
• 包含技术背景、性格特点、工作风格等
• 不要放隐私信息（手机号、密码等）
• 会随时间积累更新，越写越准 AI 越好用

---

5. TOOLS.md —— 环境备忘录

一句话理解：TOOLS.md 是 AI 的"本地工具备忘录"。

# TOOLS.md - 本地环境备忘录

### GitHub
- 仓库: https://github.com/username/repo
- 本地路径: /Users/me/projects/repo

### 凭证
- 统一管理: ~/.config/credentials.json

核心要点：

• 只记硬信息，不控制工具能力
• 记录本地路径、设备名、凭证引用等
• 凭证信息用占位符引用（如 ~/.config/credentials.json），不直接写密钥
• 技能（skills）管"怎么用工具"，TOOLS.md 管"工具有哪些"

---

6. MEMORY.md + memory/ —— 记忆系统

一句话理解：这是 OpenClaw 最核心的设计之一——AI 的持久化记忆。

OpenClaw 的记忆分两层：

MEMORY.md（长期记忆）

# MEMORY.md - 长期记忆

## 安全规则
- 不得随意修改 OpenClaw 相关文件

## 重要决定
- 2026-04-07: 公众号发布必须用 API，不用浏览器自动化
- 2026-04-07: Get笔记知识库 ID: 学习(K0BdMzmn)、工作(vnrr9VBn)

• 存放提炼过的核心知识：决定、规则、经验教训
• 仅在主会话加载（群聊中不加载，防止隐私泄露）
• 会占用上下文窗口，所以要精简

memory/YYYY-MM-DD.md（每日日志）

# 2026-04-07

## 公众号发布
- AI热点Top10文章推送到草稿箱
- 踩坑: 外链在公众号里点不了，必须改成纯文本

## Get笔记整理
- 新建2个知识库: AI与科技、音乐学习
- 归档了42条未归档笔记

• 存放当天发生的原始记录
• 不会自动注入上下文，AI 需要时用 memory_search 工具搜索
• 相当于 AI 的"日记本"

配合使用

每日日志(memory/)  →  定期提炼  →  长期记忆(MEMORY.md)

建议在心跳（Heartbeat）中定期整理，把每日日志中有价值的内容提升到 MEMORY.md。

---

7. HEARTBEAT.md —— 心跳任务

一句话理解：HEARTBEAT.md 让 AI 可以"主动干活"。

# HEARTBEAT.md

## 定期检查
- 每天早上检查日历（未来2小时有会议则提醒）
- 每隔2小时检查一次未读邮件

• 心跳是 OpenClaw 定期（约30分钟）向 AI 发送的轮询请求
• 如果 HEARTBEAT.md 为空或只有注释，AI 直接回复 HEARTBEAT_OK，不消耗额外 token
• 建议内容精简，否则每次心跳都烧 token
• 适合放周期性检查任务，不适合放精确时间任务（精确时间用 Cron）

---

8. BOOTSTRAP.md —— 首次启动引导

一句话理解：只运行一次的"新手教程"。

# BOOTSTRAP.md - Hello, World

## The Conversation
Don't interrogate. Don't be robotic. Just... talk.

Start with something like:
> "Hey. I just came online. Who am I? Who are you?"

Then figure out together:
1. Your name
2. Your nature
3. Your vibe
4. Your emoji

## When You're Done
Delete this file.

• 只在全新工作区第一次启动时创建
• 引导 AI 和用户一起"认识彼此"
• 完成后必须删除，否则每次会话都会提示

---

四、配置文件之间的关系

SOUL.md（性格） ──┐
                  ├──→ AGENTS.md（行为准则） ──→ 工作区（文件、工具、记忆）
USER.md（用户）  ──┤
                  └──→ IDENTITY.md（身份）   ──→ 对外表现（聊天、群组、发布）
                                                       │
MEMORY.md（长期记忆）←── memory/（每日日志）←── 每天发生的事
                                                       │
HEARTBEAT.md（心跳）──→ 定期主动检查
TOOLS.md（工具）──────→ 本地环境引用
BOOTSTRAP.md ────────→ 首次启动后删除

简单理解：

• SOUL + IDENTITY = AI 是谁
• USER = 帮谁
• AGENTS = 怎么做
• MEMORY + memory/ = 记住什么
• TOOLS = 用什么
• HEARTBEAT = 什么时候主动干活

---

五、和 Claude Code 配置的对比

文件	OpenClaw	Claude Code	区别
项目说明	AGENTS.md	CLAUDE.md	类似，但 OpenClaw 更偏行为规范
编码规范	AGENTS.md 中自定义	rules/	Claude Code 拆分更细
人格定义	SOUL.md + IDENTITY.md	❌ 无	OpenClaw 独有
用户档案	USER.md	❌ 无	OpenClaw 独有
记忆	MEMORY.md + memory/	memory/	OpenClaw 多了一层长期记忆
技能	skills/	skills/	类似
工具备忘	TOOLS.md	❌ 无	OpenClaw 独有
心跳	HEARTBEAT.md	❌ 无	OpenClaw 独有
启动引导	BOOTSTRAP.md	❌ 无	OpenClaw 独有

---

六、实际配置建议

新手入门顺序

1. 先用默认配置跑起来 —— openclaw onboard 会自动创建所有模板文件
2. 填 SOUL.md —— 定义你想要的 AI 性格
3. 填 USER.md —— 让 AI 了解你
4. 配置渠道 —— 连接微信、Telegram 等
5. 开始使用 —— 在对话中让 AI 自动学习

进阶优化

• 精简 MEMORY.md：只保留真正重要的长期知识，太长会浪费上下文
• 善用 Heartbeat：把需要定期检查的任务放进去，但保持精简
• 隔离隐私：MEMORY.md 不推 Git，credentials.json 放在 ~/.config/
• 定期整理：利用心跳周期性地把 memory/ 里的日志提炼到 MEMORY.md

常见误区

❌ 把所有规则塞进 AGENTS.md
✅ 安全规则放 AGENTS.md，项目规范可以用 skills 管理

❌ MEMORY.md 写太长
✅ 定期清理，只保留核心知识。每日细节放 memory/

❌ 在 USER.md 里写隐私信息
✅ 只写公开背景，凭证统一放 ~/.config/credentials.json

❌ 忘了删 BOOTSTRAP.md
✅ 首次配置完成后立即删除

---

七、总结

OpenClaw 的配置体系可以理解为：

SOUL.md     →  AI 的性格
IDENTITY.md →  AI 的身份
USER.md     →  用户的档案
AGENTS.md   →  行为准则
MEMORY.md   →  长期记忆
memory/     →  每日日志
TOOLS.md    →  工具备忘
HEARTBEAT.md → 定期任务
BOOTSTRAP.md → 新手引导（用完即删）

这套体系的核心思想是：AI 不只是一个工具，而是一个有记忆、有性格、能主动帮忙的"搭子"。 配置文件就是塑造这个搭子的模具。

配置好之后，你的 AI 就不再只是一个聊天机器人，而是：

• 知道你是谁（USER.md）
• 知道自己是谁（SOUL.md + IDENTITY.md）
• 记得之前的事（MEMORY.md + memory/）
• 知道该怎么做（AGENTS.md）
• 能主动干活（HEARTBEAT.md）

配置好这些文件，你就拥有了一个真正理解你的 AI 搭子。

---

如果这篇文章对你有帮助，欢迎点赞 👍

后面我还会分享：

• OpenClaw 多渠道配置实战（微信、Telegram、飞书）
• OpenClaw Skills 技能开发指南
• OpenClaw + Claude Code / Codex 联动工作流