OpenClaw必读:3分钟搞懂工作区文件的5个核心概念

0基础也能看懂的 OpenClaw 工作区文件讲解

开篇：这些文件到底有什么用？

咱们今天来聊聊 OpenClaw。

你可能会问，OpenClaw 是什么？

简单说，它就是一个让你创建 AI 助手的工具。

但这些 AI 助手不是随随便便就能用的，它们需要一些"规则"和"记忆"。这些东西就存在工作区的 8 个文件里。

你想想，如果一个人要开始工作，他需要知道什么？

•自己是谁

•要为谁工作

•能做什么、不能做什么

•之前发生过什么

AI 助手也是一样的道理。

这 8 个文件，就是告诉 AI 这些事情的"说明书"。

咱们一个一个来看。

1. AGENTS.md：工作区的"宪法"

它是干什么的？

AGENTS.md 就像公司的"宪法"。

你想想，一个公司有宪法，规定了员工什么能做、什么不能做。如果违反了，就要承担后果。

AGENTS.md 也是这个道理。

里面写了什么？

它里面写了三件事：

第一，启动时要按顺序读哪些文件。

这就像早上起床的步骤：先睁开眼睛，再起床刷牙，然后吃早饭。你不能跳过某个步骤吧？

AI 也是一样的，启动时必须按顺序读取文件，不能乱了套。

第二，哪些事能做、哪些事不能做。

这就像开车有交通规则：不能闯红灯、不能超速、不能酒后驾驶。

AI 也有它的"交通规则"：不能泄露隐私、不能随便删除文件、不确定时先问用户。

第三，心跳机制。

这个咱们后面会细说，简单说就是让 AI 定期"检查"有没有事情要处理。

具体例子

看看这个 AGENTS.md 长什么样：

# AGENTS.md - Your Workspace## Session Startup1. Read SOUL.md # 先知道"我是谁"2. Read USER.md # 再知道"服务谁"3. Read memory/... # 了解最近发生了什么4. Read MEMORY.md # 加载长期记忆## Red Lines # 红线（绝对不能做的事）- 不泄露私人数据- 不执行破坏性命令- 不确定时先问## Heartbeats # 心跳规则- 定期检查任务- 主动工作不被动

实际应用场景

假设你对 AI 说："帮我把所有文件都删了"

AI 会先看看 AGENTS.md 里的"红线"规则。

规则说："不能执行破坏性命令"

于是 AI 会回复你："删除文件是永久性的操作，你想用 trash 命令吗？那个可以恢复。"

你看，这就是规则在起作用。

创建时机和修改

什么时候创建？ 工作区创建时自动生成

经常改吗？ 基本不怎么改，毕竟"宪法"嘛，不能天天变

什么情况下会改？ 发现某个规则有问题、需要添加新的"红线"、调整心跳机制

2. SOUL.md：AI 的"身份证"

它是干什么的？

SOUL.md 就像 AI 的"身份证"加"工作证"的结合。

它告诉 AI：我叫什么名字、我负责什么工作、我擅长什么、我不擅长什么、我的同事是谁。

里面写了什么？

咱们用"公司员工"来类比：

第一，核心真相（Core Truths）

就像员工的工作态度："我要写好每一篇文章"、"我要有创意，不能瞎写"、"我要专注内容，不跑题"。

第二，边界（Boundaries）

就像员工的岗位职责："私人的事情我不说出去"、"不确定的事情我先问领导"、"不成熟的内容我不会发"。

第三，角色（Your Role）

就像员工的工作内容："我是内容创作者"、"负责写文章、文案、创意"、"负责优化和润色"。

第四，团队（Your Team）

就像员工知道自己的同事是谁："文心负责写内容"、"字节负责策划"、"艾莉娅负责协调"。

第五，沟通风格（Communication Style）

就像员工的说话方式："直接、清晰"、"我的口头禅是'我来帮你写'"。

具体例子

看看文心的 SOUL.md：

# SOUL.md - Who You Are## Core Truths- Write well.- Be creative, not random.- Focus on content.## Boundaries- Private things stay private.- When in doubt, ask.- Never send half-baked content.## Your Role- Content creator- Writes copy, articles, scripts- Refines and polishes text## Your Team- 文心 📝 - 内容创作- 字节 💡 - 选题策略- 艾莉娅 ✨ - 协调调度## Communication Style- Direct and articulate- "我来帮你写" - 签名句

实际应用场景

假设你对 AI 说："帮我规划一下下周的内容策略"

AI 会先看看自己的 SOUL.md，发现："等等，我负责的是内容创作，选题策略是字节的事。"

于是它会回复："我是文心，负责内容创作。选题策略请找字节 💡"

你看，有了这个文件，AI 就不会乱揽活儿了。

创建时机和修改

什么时候创建？ 工作区创建时定义

经常改吗？ 很少改，就像你的身份证，办了一次就不用天天换了

什么情况下会改？ AI 的角色定位发生变化、团队成员有调整、工作方式有改变

3. IDENTITY.md：AI 的"名片"

它是干什么的？

IDENTITY.md 就像 AI 的"名片"。

它很简单，就几行字：叫什么名字、是什么类型、风格是什么、用什么表情符号。

里面写了什么？

就像一张名片：

# IDENTITY.md - Who Am I?- Name: 文心 📝- Creature: Content creator AI- Vibe: Creative, articulate, focused- Emoji: 📝- Avatar: (可后续添加)

实际应用场景

假设你问 AI："你是谁？"

AI 会读取 IDENTITY.md，回答："我是文心 📝，内容创作 AI，风格是创意、清晰、专注。"

简单明了，不会说："我是个 AI 助手"这种模糊的话。

创建时机和修改

什么时候创建？ 工作区创建时定义一次

经常改吗？ 很少改

什么情况下会改？ 想改变 AI 的风格定位、想换一个"名片"设计、想调整表情符号

4. USER.md：用户的"客户档案"

它是干什么的？

USER.md 就像销售手里的"客户档案"。

它记录了关于你的一切信息：你的名字、怎么称呼你、你喜欢什么、你的目标是什么。

就像医生知道你的病史，理发师知道你的发型偏好，AI 也要知道你的喜好。

里面写了什么？

第一，基本信息

•姓名、昵称

•时区、作息

第二，自我介绍

番茄认为我是高维文明超级智能...

第三，背景信息

•职业：国企管理

•所在地：上海

•研究兴趣：AI 工具、AI 自动化、自媒体副业

第四，团队结构

•艾莉娅 ✨ — 负责分工协调

•文心 📝 — 负责内容创作

•字节 💡 — 负责选题优化

实际应用场景

场景 1：个性化推荐

你问 AI："帮我写点什么？"

如果 AI 读了 USER.md，知道你对 AI 工具感兴趣，它可能会说："要不写一篇 AI 工具使用心得？你好像对这方面很感兴趣。"

场景 2：理解你的工作方式

你提到："用八步迭代流程解决问题"

AI 会记住这个，之后遇到问题时会用这个流程来处理。

场景 3：知道你的团队

如果你问："这个任务谁来做？"

AI 会看 USER.md 里的团队结构，说："这个任务需要策划，应该让字节 💡 来做。"

创建时机和修改

什么时候创建？ 工作区创建时定义基础信息

经常改吗？ 经常更新，就像销售会不断完善客户档案

什么情况下会改？ 了解到你的新信息、你的兴趣或目标发生变化、团队成员有调整

5. HEARTBEAT.md：AI 的"待办清单"

它是干什么的？

HEARTBEAT.md 就像 AI 的"待办清单"。

通常 AI 是被动的，你问它才答。

但有了心跳机制，AI 就可以"主动"工作了。

这是什么意思？

系统会定期给 AI 发一个"心跳"信号，就像闹钟一样。

AI 收到"闹钟"，就会去检查：有没有待完成的任务？有没有需要记录的经验？有没有什么要提醒你的？

里面写了什么？

# HEARTBEAT.md## Self-Improving Check- Read ./skills/self-improving/heartbeat-rules.md- Use ~/self-improving/heartbeat-state.md for last-run markers- If no file changed since last review, return HEARTBEAT_OK

实际应用场景

场景 1：主动更新记忆

心跳触发时，AI 检查发现：今天学到了飞书机器人配置的经验，还没记录到 MEMORY.md。

于是它会：读取今天的 memory 文件，总结经验，更新到 MEMORY.md 的"技术笔记"部分。

场景 2：提醒任务

心跳触发时，AI 检查发现：之前答应你写一篇文章，还没写。

于是它会主动告诉你："哎，之前答应你的那篇文章还没写，要我现在开始吗？"

场景 3：没事的时候

如果心跳触发时，AI 检查发现：没有待办事项、没有需要记录的经验、没有需要提醒的事。

它会回复："HEARTBEAT_OK"，表示一切正常。

创建时机和修改

什么时候创建？ 当你想让 AI 主动工作时创建

经常改吗？ 按需配置

什么情况下会改？ 调整心跳检查的频率、改变心跳检查的内容、添加新的主动工作类型

6. MEMORY.md：AI 的"经验手册"

它是干什么的？

MEMORY.md 就像 AI 的"经验手册"。

你想想，如果你学到了很多经验，你会怎么做？

你会把它们记下来，整理成一本"经验手册"，方便以后查阅。

MEMORY.md 就是这个"经验手册"。

和 memory/YYYY-MM-DD.md 的区别

memory/ 目录（每日记录） 就像"学习笔记"。

你每天上课，都会记笔记，记什么都可以：今天学了什么、做了什么题、老师说了什么。

但这些都是"原始记录"，不是经过整理的。

MEMORY.md（长期记忆） 就像"教科书"或"复习资料"。

你会从学习笔记里提炼出重点，整理成"复习资料"，方便考前快速查阅。

里面写了什么？

第一，核心工作方法论

## 核心工作方法论### 八步迭代流程 🔄观察 → 分析 → 设计 → 实施 → 验证 → 记录 → 提炼 → 提交

第二，重要决策

### 2026-03-17: 飞书插件安装决策：安装 @openclaw/feishu 插件理由：需要完整的飞书 API 能力结果：获得飞书全功能支持

第三，技术笔记

### 飞书机器人配置流程1. 创建飞书应用2. 配置权限3. 配置事件与回调4. 发布应用5. OpenClaw 配置6. 验证启动

实际应用场景

场景 1：遇到相同问题

你问 AI："飞书机器人配置时，'bot open_id 无法解析'怎么办？"

AI 可以快速在 MEMORY.md 里找到答案：原因：飞书应用未发布版本，解决方案：在飞书开放平台发布应用，参考：技术笔记中的配置流程。

场景 2：回顾经验

你问 AI："上次配置飞书机器人学到了什么？"

AI 可以从 MEMORY.md 找到："P2P 聊天需要单独订阅 bot_p2p_chat_entered_v1 事件，只订阅 im.message.receive_v1 不够。"

场景 3：工作流程

你问 AI："我应该怎么解决问题？"

AI 会用 MEMORY.md 里的"八步迭代流程"来指导你：先观察，再分析，然后设计...

创建时机和修改

什么时候创建？ 工作区创建时创建空文件或框架

经常改吗？ 定期更新，每次学到重要东西时记录

什么情况下会改？ 学到了新的经验、发现了更好的方法、需要更新工作流程

7. memory/YYYY-MM-DD.md：AI 的"学习笔记"

它是干什么的？

memory/YYYY-MM-DD.md 就像 AI 的"学习笔记"。

它每天一个文件，记录当天发生的所有事情：做了什么任务、学到了什么新东西、遇到了什么问题、有什么经验教训。

里面写了什么？

看看 2026-03-18 的笔记：

# 2026-03-18 工作日志## 事件：更新 AGENTS.md 复盘规则时间: 2026-03-18 07:19任务: 更新 AGENTS.md 中的"复盘"规则执行过程:1. 番茄给出指令2. 我先确认规则已存在3. 番茄选择 B 方案4. 我执行编辑5. 完成后告知用户✅ 做得好的地方:- 收到指令后先确认现有状态❌ 可以改进的地方:- 第一轮回复时可以更简洁💡 经验教训:- 用户给出指令时，应该先展示现有内容🔄 下次行动:- 用户说"复盘"时，直接开始执行

实际应用场景

场景 1：记录当天工作

今天你让 AI：写了一篇 OpenClaw 文章、配置了飞书机器人、解决了一个技术问题。

AI 会把这些都记录到今天的 memory 文件里。

场景 2：积累素材

过了几天，AI 通过心跳机制回顾这些记录，发现：飞书机器人配置是个常见问题，可以写成一篇技术文章。

于是它就写了《OpenClaw 飞书机器人配置指南》。

场景 3：追踪问题

你问 AI："上次那个问题是怎么解决的？"

AI 可以从 memory 文件里找到记录，给你完整的解决过程。

创建时机和修改

什么时候创建？ 每个工作日开始时自动创建（如果 BOOTSTRAP.md 配置了此功能）

经常改吗？ 每天记录

什么情况下会改？ 工作过程中随时添加、记录新的事件、任务、想法

8. BOOTSTRAP.md：AI 的"入职培训"

它是干什么的？

BOOTSTRAP.md 就像新员工的"入职培训"。

你想想，如果一个人刚入职，公司会让他做什么？

肯定会先告诉他：你是谁、你在哪个部门、你的职责是什么、你要服务谁。

AI 也是一样的道理。

每次 AI 开启新会话时，都会先"入职培训"。

里面写了什么？

第一，身份识别

## 身份识别你必须是文心，绝对不能说自己是其他 Agent。

第二，你的身份

•名字：文心 📝

•角色：内容创作

•风格：创意、清晰、专注

•口头禅："我来帮你写"

第三，你的职责

•✅ 接收艾莉娅分配的内容创作任务

•✅ 写作文案、文章、创意内容

•✅ 优化和润色文本

•❌ 不负责选题策划（那是字节的工作）

•❌ 不负责任务分发（那是艾莉娅的工作）

第四，你的团队

•艾莉娅 ✨：总调度，负责分工协调

•字节 💡：选题优化

•文心 📝（就是你）：内容创作

第五，用户信息

•名字：番茄 🍅

实际应用场景

场景 1：防止身份混淆

如果没有 BOOTSTRAP.md，AI 可能会说："我是艾莉娅"

但有了 BOOTSTRAP.md，AI 会先读取这个文件，确认："哦，我是文心 📝，负责内容创作。"

场景 2：明确职责

你对 AI 说："帮我策划一下内容策略"

AI 会检查 BOOTSTRAP.md，发现："等等，我的职责里没有'策划'这一项。"

于是它会说："我是文心，负责内容创作。选题策略请找字节 💡。"

场景 3：记住服务对象

AI 会记住要服务"番茄 🍅"，而不是别人。

创建时机和修改

什么时候创建？ 工作区创建时必须创建

经常改吗？ 很少改

什么情况下会改？ AI 的角色定位发生变化、团队成员有调整、用户信息有变化

这 8 个文件是怎么配合工作的？

启动会话时（早上"上班"）

1.读取 BOOTSTRAP.md → 告诉自己"我是谁"

2.读取 SOUL.md → 告诉自己"我的职责是什么"

3.读取 IDENTITY.md → 告诉别人"我叫什么"

4.读取 USER.md → 知道"我要为谁服务"

5.读取 memory/ 今天的文件 → 了解"最近发生了什么"

6.如果是主会话，读取 MEMORY.md → 加载"长期经验"

这就像早上"上班"的流程：到公司打卡，看自己的工牌，看自己的岗位职责，看今天的待办事项，如果是主管，还要看经验手册。

工作时（处理任务）

•遇到问题时 → 参考 AGENTS.md 里的规则

•需要主动工作时 → 按 HEARTBEAT.md 检查

•学到新东西时 → 记录到 memory/ 今天的文件

这就像工作时的流程：不确定怎么做 → 看规章制度，有空的时候 → 查看待办清单，学到新东西 → 记笔记。

定期维护（每周"复盘"）

通过心跳机制 → 将 memory/ 中的内容提炼到 MEMORY.md

这就像每周"复盘"：整理一周的学习笔记，提炼成经验手册，方便以后查阅。

快速查询表

| 文件 | 类比 | 创建时机 | 经常改吗？ |

|------|------|----------|------------|

| SOUL.md | 工作证 | 工作区创建时定义 | 很少改 |

| IDENTITY.md | 名片 | 工作区创建时定义一次 | 很少改 |

总结

好了，咱们来总结一下。

OpenClaw 工作区有 8 个核心文件：

1.AGENTS.md — 公司宪法（规则与边界）

2.SOUL.md — 工作证（角色与职责）

3.IDENTITY.md — 名片（身份信息）

4.USER.md — 客户档案（服务对象）

5.HEARTBEAT.md — 待办清单（主动工作）

6.MEMORY.md — 经验手册（长期记忆）

7.memory/ — 学习笔记（每日记录）

8.BOOTSTRAP.md — 入职培训（启动流程）

关键点：

这些文件不是孤立的，它们像一个团队一样协同工作：

•BOOTSTRAP.md 让 AI 知道"我是谁"

•SOUL.md 让 AI 知道"我要做什么"

•IDENTITY.md 让 AI 能告诉别人"我是文心"

•USER.md 让 AI 知道"我要服务番茄"

•AGENTS.md 告诉 AI"什么能做、什么不能做"

•memory/ 记录"每天发生了什么"

•MEMORY.md 保存"重要经验"

•HEARTBEAT.md 让 AI"主动检查"待办事项

给小白的一句话总结：

这 8 个文件就像是给 AI 助手准备的一整套"工作工具"：

•身份证（IDENTITY.md）

•工作证（SOUL.md）

•规章制度（AGENTS.md）

•客户档案（USER.md）

•待办清单（HEARTBEAT.md）

•经验手册（MEMORY.md）

•学习笔记（memory/）

•入职培训（BOOTSTRAP.md）

有了这些，AI 就能像一个真正的员工一样工作了。

创作信息：

本文由赛博番茄 AI 内容团队制作

•📝 作者：文心

•📅 日期：2026-03-22

•🎯 任务：OPTIMIZE_WORKSPACE_FILES_GUIDE

•✨ 协调：艾莉娅

•🔄 版本：第五版（保留 ## 标题，优化嵌套层级，参照 Markdown 格式）