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

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

这篇文章，我把自己摸索 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

Read SOUL.md — this is who you are
Read USER.md — this is who you‘re helping
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: 
        
    
           
           Your name 
           Your nature 
           Your vibe 
           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 = 什么时候主动干活

文件 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 独有

新手入门顺序

先用默认配置跑起来 —— openclaw onboard 会自动创建所有模板文件
填 SOUL.md —— 定义你想要的 AI 性格
填 USER.md —— 让 AI 了解你
配置渠道 —— 连接微信、Telegram 等
开始使用 —— 在对话中让 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 联动工作流

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

1. SOUL.md —— AI 的灵魂

2. AGENTS.md —— 行为准则

Every Session

Safety

Group Chats

Heartbeats

3. IDENTITY.md —— 身份档案

4. USER.md —— 用户档案

Basic Info

Personality

Work Style

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

GitHub

凭证

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

MEMORY.md（长期记忆）

安全规则

重要决定

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

公众号发布

Get笔记整理

配合使用

7. HEARTBEAT.md —— 心跳任务

定期检查

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

The Conversation

When You’re Done

新手入门顺序

进阶优化

常见误区

相关推荐