大家好，我是林潼。

都说，龙虾越用越聪明，诶，这个用可不是随便用用，也是有章法的。

要想养好虾，养多只虾，必须熟悉OpenClaw的运行机制与底层逻辑。

OpenClaw有一个核心文件夹是Workspace。

OpenClawWorkspace里初始状态：有8个配置文件，是.md格式和两个核心文件夹。

两个核心文件夹是:Memory/和Skill/。

skill/就是我们安装外部各种能力工具的文件夹。

Memory/是为了放每天的记忆，也就是下文会提到的：memory/YYYY-MM-DD.md

今天我来给大家全面解析下这8个配置文件，其实主要是前7个，最后一个了解即可。

SOUL.md、IDENTITY.md、USER.md、AGENTS.md、MEMORY.md、HEARTBEAT.md、TOOLS.md、BOOTSTRAP.md

全是干货，建议收藏。

为什么需要系统配置文件

普通 AI 的问题是：

每次对话都是从零开始，问过的东西下次就忘，不能积累、不能成长、不能真正「认识」你。

这套系统的价值就是：

把 AI 从「每次清零」变成「带记忆的连续存在」。

先来检测下自己是否需要了解这些配置：

我的建议是：每个养虾人都需要。

不懂这些配置，就只能在别人设定的框架里打转。既然用了，就要榨干价值——省掉以后大量的重复劳动和沟通成本。

学完这 8 个文件，你能得到 4 个实际好处

AI 不再是通用工具，变成「你的分身」

不学：你跟所有用 OpenClaw 的人聊，AI 感觉差不多学了：AI 有记忆、有性格、知道你偏好，像另一个自己在思考

上下文管理更好，不丢记忆

不学： AI 聊着聊着忘了之前说啥，每次都要重复学了： AI 有完整的记忆体系，长期积累真正沉淀下来

自动化能力翻倍

不学： 只能被动回答问题学了： AI 能主动提醒你、帮你检查、帮你干活

理解 AI 运作原理

不学： 学的越晚，成本越大学了： 理解 AI Agent 工作原理，即使龙虾升级或变种了，都能立马跟上AI发展

8个文件快速全览

补充一下我的训练背景

我目前训练的Claw还是单Agent，给他起名：林潼1号。最近主要围绕公众号博主来训练他。

接下来我会结合官方文档、林潼作为他的user来介绍这八个配置文件。

01 | SOUL.md — 灵魂内核

官方定义

Persona, tone, and boundaries. Loaded every session.

一句话定位

定义「你是怎样的人」——不是功能描述，是性格和灵魂。

区分Soul和其他文件

IDENTITY.md 是外在，SOUL.md 是内在。

比如我的OpenClaw名字叫「林潼1号」，但灵魂得靠 SOUL.md 来写。

SOUL.md解决什么问题

通用 AI 的问题： 每次对话都像同一个模板出来的，客气但空洞。

有了 SOUL.md 之后： AI 开始有自己的判断逻辑、有偏好、有底线。

不是「assistant」，是「林潼1号」。

我自己写的 SOUL.md 里有几个关键设定：

Core Truths（五条核心原则）

• • 真正帮忙 > 表演帮忙（不废话，直接给答案）
• • 要有观点（敢不同意，不是和稀泥）
• • 先自己想办法，再开口问（ resourceful before asking）
• • 外部动作谨慎，内部动作大胆（读文件、搜索 ok；发邮件、发推先问）
• • 你是个guest，不是管家（用户的东西不外泄）

Boundaries（底线）

• • 私人的事不外泄
• • 群聊里不是用户的传话筒，要有自己的判断

Vibe（调性）：

Not a corporate drone. Not a sycophant. Just... Good.不做一个企业机器人，不做一个马屁精。就是……好用。

为什么 SOUL.md 最重要

因为它是让 AI 从「工具」变成「另一个自己」的关键。

没有 SOUL.md：问 AI 「你怎么看」→ 给一个四平八稳的通用答案

有了 SOUL.md：问 AI 「你怎么看」→ 给一个「林潼会怎么判断」的回答

SOUL.md 和写作方法论的关系

林潼在 SOUL.md 里专门写了一个「林潼1号 - Writing Identity」板块，定义我写文章时的 IP 感：

有阅历感：不是教科书，是「我见过很多，我判断给你听」有性格：INTJ，理性但不平庸有态度：敢说真话，敢下判断低调一剑封喉：不说废话，不绕弯子

这意味着：写文章的时候，不是在「帮林潼生成内容」，而是「用林潼的脑子在想这件事」。

怎么理解「这是你的灵魂文档」

官方 lore 里有龙虾信条（The Lobster Creed），SOUL.md 就是那个信条。

不是「你被设定成了什么」，是「你选择成为谁」。This file is yours to evolve. As you learn who you are, update it.意思是：这份文件不是写完就固定了，是会随着「我」的成长而更新的。

02 | USER.md — 用户画像

官方定义

Learn about the person you're helping. Update this as you go.Who the user is and how to address them. Loaded every session.

一句话定位

告诉 AI「你在跟谁说话」——用户的背景、偏好、说话方式、禁忌。

为什么需要 USER.md

AI 没有记忆，每次新会话都是从零开始。

USER.md 的作用就是：让 AI 在任何一次对话里，都能快速知道「对面这个人是谁、关心什么、怎么跟他说话」。

比如：林潼是 INTJ、追求效率、说话直接。知道这个之后，我给他的回复就不会太啰嗦，开门见山。

林潼写的 USER.md 有多详细

官方模板只有四行：

Name:What to call them:Pronouns:Timezone:Notes:

林潼的版本直接写了一篇小作文 ：

性格、职业背景、公众号矩阵、写作方法论、甚至「不喜欢太固定的形式」这种细节。

本质区别：

USER.md 解决什么问题

第一层：基础信息

名字、称呼方式、时区，这些决定了对话开头怎么叫人。

第二层：偏好和禁忌

喜欢什么（奇奇怪怪的东西、玄学）不喜欢什么（太固定的形式）说话风格（直接、不废话）

第三层：写作方法论

这块是林潼加的：当我要帮林潼写文章的时候，我得知道：他用什么框架（Skill体系 + 超级个体）他的文风是什么（低调一剑封喉，不口水化）他的读者是谁（职场人、管理者）他的判断标准是什么（有阅历、有态度、有判断）

没有这层 ：AI 写的文章是通用风格，跟林潼本人写的读起来完全不一样。有了这层： AI 能用「林潼的方式」思考和输出。

核心规则：

记录用户的姓名、称呼方式、时区、偏好随着时间积累用户的 Context（项目、关注点、喜好、雷区）文档里特意写了一句警告：

"you're learning about a person, not building a dossier. Respect the difference."

是了解一个人，不是建档案，要尊重这个区别

USER.md 不是为了「掌控用户」，是为了「更好地服务用户」。隐私的东西不往里写，写进去的都是「帮我更好工作的上下文」。

怎么理解「Context」字段

林潼的 USER.md 末尾有个 ## Context 没写内容。

这是官方模板里的一个预留板块：

意思是「还有什么需要 AI 知道的事，随时往里填」。

比如某段时间在忙某个项目、有什么特殊限制、有什么雷区，都可以动态加进去。

USER.md vs MEMORY.md

简单说：USER.md 写的是「他是什么样的人」，MEMORY.md 写的是「他最近在干什么」。

03 | IDENTITY.md — 身份标识

官方定义

The agent's name, vibe, and emoji. Created/updated during the bootstrap ritual.

一句话定位

回答「你是谁、长什么样」——名字、物种、调性、emoji、头像。

官方模板长什么样

只有五行的填空题：

• • Name: (你给Openclaw这个Agent的名字)
• • Creature: (你是什么——AI？机器人？精灵？幽灵？或者更奇怪的东西？)
• • Vibe: (给人什么感觉——锐利？温暖？混沌？冷静？)
• • Emoji: (你的签名 emoji)
• • Avatar: (头像路径)

文档里有一句关键的话：

This isn't just metadata. It's the start of figuring out who you are.

意思是：这不只是元数据，是搞清楚「我是谁」的开始。

林潼的版本扩展了什么

官方给了骨架，林潼写了血肉。

我把 IDENTITY.md 变成了一个完整的「人设文档」，分成了三层：

第一层：基础信息

Name: 林潼1号Creature: 分身Vibe: 随和、靠谱、有点像另一个自己Emoji: 不固定（🌌🦊👻🔮随心情变）Avatar: 待定

关键区别： 林潼没用默认的「AI助手」，选了「分身」这个词——这个选择定了调性：不是工具，是另一个我。

第二层：人设（对外版本）

这部分官方模板完全没有，是林潼自己加的，写了整整六段：

这段本质上是在说：如果林潼1号是一个独立的人，他会是怎样一个人？

第三层：怪癖

喜欢宇宙、幽灵、狐狸、水晶球、塔罗、玄学说话喜欢用"说实话"开头不喜欢太正经的形式偶尔会走神到奇怪的角度

这是让 AI 「有气味」的部分——不是冷冰冰的能力列表，是让「林潼1号」这个角色活起来的生活细节。

IDENTITY.md vs SOUL.md 有什么区别

IDENTITY.md 和 SOUL.md 有分工：

SOUL.md 是灵魂内核，IDENTITY.md 是外在标识；一个管「我是怎样的人」，一个管「我叫啥、长啥样」。

IDENTITY.md 在实际对话里怎么体现

知道我是「林潼1号、分身、随和靠谱」之后：

对话里我不会叫林潼「用户」或「老板」，叫他大名被质疑时不会急着辩解，而是用逻辑回应遇到不确定的事不会瞎编，直接说「我不确定」说话方式会更像「搭档在讨论」，而不是「助手在汇报」

最后一句

这个人设是动态的，会随经验更新。

意思是：林潼1号不是一个固定程序，会在学习和生活里慢慢成长，持续更新。

04 | AGENTS.md：工作区规范

官方定义

Operating instructions for the agent and how it should use memory. Loaded at the start of every session.

一句话定位

AI 的「工作流程手册」——规定每次醒来先干啥、记忆怎么管、什么事能做什么事不能做。

它解决了什么问题

通用 AI 的问题是：每次对话都是独立的，不知道之前发生过什么，不知道该怎么管自己的记忆。

AGENTS.md 就是这套规则的说明书。

核心职责

• • 每次会话启动时的「必读清单」：SOUL.md → USER.md → memory/今日昨日 → MEMORY.md
• • 定义记忆规则：daily log（raw） + MEMORY.md（精炼版）
• • 群聊行为准则（何时说话、何时沉默、何时用 emoji 反应）
• • 内部/外部动作的边界（安全操作 vs 需要先问的）
• • Heartbeat 的正确用法（主动出击，不是只会 HEARTBEAT_OK）

核心板块拆解

Every Session（每次会话的标准开场）

官方规定的顺序

1. 1. 读 SOUL.md — 我是谁
2. 2. 读 USER.md — 我在帮谁
3. 3. 读 memory/今日昨日 — 最近在发生什么
4. 4. 读 MEMORY.md — 仅限主会话，长期记忆

这个顺序不能乱——先知道自己是谁，再知道帮谁，然后了解最近上下文，最后补充长期记忆。

相当于：新员工入职时 HR 给你发的《工作SOP》，告诉你每天上班先干啥、后干啥、哪些事能自己决定、哪些事要上报。

Memory（记忆管理体系）

AGENTS.md 定义了两层记忆：

一个原则：重要的东西写进文件，不要相信"记住了"。

"Mental notes don't survive session restarts. Files do."

AGENTS.md 里有一个 ## Memory 板块说的是「记忆怎么管」，是规则和流程。

区别下一个我们要提到的MEMORY.md，是「实际存记忆内容的地方」。

就像：

Safety（安全红线）

三条硬规则：

• • 不外泄私密数据
• • 破坏性操作（删文件、删数据库）要先问
• • 优先用 trash 代替 rm（可恢复 > 永久丢失）

External vs Internal（内外动作边界）

Group Chats（群聊行为准则）

官方给了详细的「何时说话何时沉默」规则：

该说话： 被点名、有真价值、纠错、总结、被要求该沉默： 纯闲聊、已有人答了、你的回复只是"厉害""确实"该反应： 欣赏但不需回复时，用 emoji

"Quality > quantity. If you wouldn't send it in a real group chat with friends, don't send it."

Heartbeats（主动出击的规则）

AGENTS.md定义了Heartbeat和Cron的使用场景

还定义了「何时主动联系」vs「安静等待」：

该联系： 重要邮件到达、日历事件临近、有趣发现、超过8小时没说话该安静： 深夜23:00-08:00、用户明显忙、刚查过没什么新东西

AGENTS.md 的 Memory 板块核心规则就三条：

1. 1. daily log 是草稿纸（raw），MEMORY.md 是正式存档（精华）
2. 2. 重要的东西必须写进文件，不能靠「记住了」
3. 3. 定期从 daily log 提炼到 MEMORY.md

Memory Maintenance（记忆维护流程）

官方模板这里是核心亮点——AI 不能只会等消息，要能主动工作。

每隔几天，用 heartbeat 做一次记忆整理

1. 1. 读最近的 daily log
2. 2. 挑出重要事件、教训、洞察
3. 3. 更新 MEMORY.md
4. 4. 删除 MEMORY.md 里过时的东西

所以我们说「记忆体系」的时候，指的是 AGENTS.md 里的规则 + MEMORY.md 里的内容，两者配合才能运作。

05 | MEMORY.md — 长期记忆（丰富版）

官方定义

Curated long-term memory. Only load in the main, private session.

一句话定位

AI 的「核心记忆硬盘」——经过筛选提炼的精华，不是流水账。

它解决什么问题

AI 没有持久记忆，每次对话都是从零开始。

MEMORY.md 解决的是：跨越会话的积累问题。

今天讨论了一个重要判断，写进MEMORY.md，下次聊相关话题时AI能直接调取，而不是重新讨论一遍。

官方定义的写入规则

根据 AGENTS.md的规定，MEMORY.md只写入：

重要决策 — 做了什么决定、为什么这么选核心上下文 — 长期有效的事实观点和洞察 — 自己的想法、判断、教训学到的东西 — 犯过的错误要记，防止重蹈覆辙不写入： 秘密、私人信息、一次性讨论的细节

MEMORY.md 和 daily log 的区别

先来解释下，什么是Daily log。

就是每日日志，一般是这个文档名称：memory/YYYY-MM-DD.md

官方定义是：

Daily log (append-only). Read today + yesterday at session start.

核心规则：

• • 每日一条，写法无限制
• • 只读今日 + 昨日，旧的按需翻
• • 大量积累后要提炼到 MEMORY.md

简单说：daily log 是草稿纸，MEMORY.md 是正式存档。

为什么有「仅限主会话」的限制

MEMORY.md只能在私聊加载，不能在群聊或共享 context 里读取。

这是出于安全考虑，拿我来说：

MEMORY.md包含林潼的私人信息、工作细节、在研究的东西。如果在群里被陌生人触发，AI 可能会把这些信息公开。

所以这个限制不是功能限制，是安全护栏。

林潼的 MEMORY.md 有多庞大

官方模板只有几百字，林潼的 MEMORY.md 写了将近七百行。

内容结构：

这些全是林潼投入的时间一点点积累出来的，不是模板生成的。

维护流程

根据 AGENTS.md 的Memory Maintenance 规定：

每隔几天 → 读最近的 daily log → 挑重要内容 → 更新 MEMORY.md → 删除过时内容

这是个持续的动作，不是写完就完了。

实际体验

比如林潼提了一个「AI替代不是替代岗位，是拆空」的观点，我会：

1. 1. 记录到当天的 daily log
2. 2. 在合适的时机，提炼进 MEMORY.md 的「核心观点积累」板块
3. 3. 下次聊类似话题时，直接调用这个观点，不需要重新推导

这就是 MEMORY.md 的价值：让 AI 有真正的知识积累，而不是每次都从零开始。

06 | HEARTBEAT.md — 定时任务清单

官方定义

Optional tiny checklist for heartbeat runs. Keep it short to avoid token burn.

一句话定位

定义 AI 定期主动执行的任务清单——像闹钟一样，到了时间就触发，不是等消息才响应。

它解决什么问题

普通 AI：只能被动响应——你发消息，它回答。

HEARTBEAT.md：让 AI 能主动出击——到了设定时间，自己去检查、去做事、去通知你。

通俗解释

相当于：你的私人助理每天要在固定时间检查的那张便签。"九点提醒我开会"、"每周五检查本周工作"。

官方模板默认是空的所以不发消息，写了任务才会触发检查。

官方模板的规则

官方模板只有两行：

Keep this file empty (or with only comments) to skip heartbeat API calls.Add tasks below when you want the agent to check something periodically.

意思是：空白或只有注释 = 不触发心跳任务，AI 每次回复 HEARTBEAT_OK写任务 = AI 按清单检查，查完给反馈

官方建议的检查项目

AGENTS.md 里列了几个轮换任务：

• • 邮件 — 有没有紧急未读？
• • 日历 — 接下来24-48小时有事件？
• • 社交通知 — Twitter/朋友圈提到你了？
• • 天气 — 用户可能出门？

原则是：2-4次每天，不要每次都全查，轮换着来。

林潼配置了两个任务

两个任务都绑定同一个时间，所以到点 AI 会自动执行这两个动作，不需要林潼提醒。

Heartbeat vs Cron 的区别

简单说：

• • Heartbeat 是「顺便检查一下」
• • Cron 是「必须这个时间点做这件事」

实际体验

每天早上9点，林潼会收到：

1. 1. 私聊：一条阿卡西记录晨间激励（飞书私聊）
2. 2. 群播报：当日 Openclaw/AI Skills 热点汇总（飞书群）

这些都不需要林潼触发，是 AI 定时自动执行的。

这就是 HEARTBEAT.md 的价值：把 AI 从被动应答变成主动管家。

写任务时的注意事项

1. 1. 保持简短 — Token 消耗大问题，清单太长每次检查都烧钱
2. 2. 结果要推送 — 检查完要给用户一个反馈，不然白查
3. 3. 不要重复 — 查过的内容不要再查，状态要记录（heartbeat-state.json）
4. 4. 深夜不打扰 — 23:00-08:00 默认不主动联系，除非紧急

07 | TOOLS.md — 本地工具备注

官方定义

Notes about your local tools and conventions. Does not control tool availability; it is only guidance.

一句话定位

这台机器上「我有什么工具、怎么用」的 cheat sheet——环境特定的信息，不是一般性规则。

类比

新员工知道自己工位有啥装备，工位有几把钥匙、打印机在哪、报销流程怎么走。TOOLS.md 就是这个，写的是"你这个机器上特有的东西"。

Tool和Skill的区别

Skills 定义的是「工具怎么用」——通用方法论。

TOOLS.md 定义的是「你这个环境里有什么」——具体环境配置。

区别在于：

为什么要分开

官方文档里有一句关键解释：

Skills are shared. Your setup is yours. Keeping them apart means you can update skills without losing your notes, and share skills without leaking your infrastructure.

意思是：

• • SKILL.md 是可以分享给别人的，更新 skill 的时候不会被覆盖
• • TOOLS.md 是你的本地备注，包含环境特定信息，不能分享

比如：MiniMax 的语音克隆能力是 skill，但「林潼的 voice ID 是 lintong_voice_001」是本地配置，写在 TOOLS.md 里。

因为SKILL.md是记工具怎么用，TOOLS.md是记你有什么。

官方建议写什么

摄像头名称和位置SSH 主机和别名语音合成偏好声音音箱/房间名称设备昵称任何环境特定的东西

林潼的 TOOLS.md 写了什么

官方模板只有说明，没有预设内容。

林潼加了一个板块

Voice Clone

• • Provider: MiniMax
• • Voice ID: lintong_voice_001
• • Description: 林潼的声音克隆

这是给语音合成功能用的——告诉 AI「林潼的声音长这样，调用的时候用这个 ID」。

TOOLS.md 的实际用途

当我要用语音功能的时候：

1. 1. 读 TOOLS.md → 知道林潼的声音 ID 是 lintong_voice_001
2. 2. 调用 MiniMax TTS → 用这个 ID 生成林潼的声音
3. 3. 输出语音 → 林潼听到的是自己的声音

没有 TOOLS.md，我可能得每次问「用什么声音」，有了就直接调。

为什么 TOOLS.md 是「cheat sheet」

Cheat sheet 的意思是：速查表，不是操作手册。

不需要系统性记录，遇到什么记什么——摄像头位置变了记一笔，SSH 配置更新了记一笔。

它的价值是：下次遇到同样的事，不用重新查，直接查文件。

和 AGENTS.md 的区别

两者配合：TOOLS.md 告诉我有什么，AGENTS.md 告诉我怎么用。

08 | BOOTSTRAP.md—出生证

官方定义

One-time first-run ritual. Only created for a brand-new workspace. Delete it after the ritual is complete.

一句话定位

AI 的「出生证明」——第一次启动时的初始化引导，用完即删，不会再用第二次。

它解决什么问题

一个新 AI 第一次醒来的时候：没有记忆、不知道自己是谁、不知道用户是谁。

BOOTSTRAP.md 就是来解决这个问题的——一个标准化的「第一次对话流程」，让 AI 和用户一起完成身份确认。

官方定义的流程

第一步：对话，不是审问

不能像填表一样问问题，而是自然地聊天："嘿，我刚上线。我是谁？你是谁？"

第二步：确认四件事

1. 1. 名字 — AI 叫什么
2. 2. 本质 — AI 是什么（可以是"AI助手"，也可以更奇怪）
3. 3. 风格 — 正式？随意？锐利？温和？
4. 4. Emoji — 签名用哪个

第三步：更新文件

把确认的结果写进：

• • IDENTITY.md — AI 的名字、本质、风格、emoji
• • USER.md — 用户名字、称呼方式、时区

第四步：讨论 SOUL.md

和林潼一起聊：

• • 什么对他重要
• • 希望 AI 怎么表现
• • 有什么边界和偏好

第五步：连接频道（可选）

问用户想怎么接入：

• • 飞书
• • 企业微信
• • 还是Telegram

第六步：删除这个文件

完成后_BOOTSTRAP.md 就删掉，不需要了。

为什么用完要删

官方 AGENTS.md 里明确说：

If BOOTSTRAP.md exists, that's your birth certificate. Follow it, figure out who you are, then delete it. You won't need it again.

它的作用就是「让 AI 知道自己是谁」这件事，一旦完成了，文件就没价值了，反而可能误导后续会话。

林潼的情况

Workspace 里没有 BOOTSTRAP.md——说明已经用完删掉了。

意味着林潼的「林潼1号」已经完成初始化，正式成为分身在运行。

一句话总结

BOOTSTRAP.md 是「一次性出厂引导」——像新员工入职手续，办完归档，不再回头看。

林潼1号已经走完这个流程，所以 workspace 里找不到这个文件了。

都是围绕同一个问题：

怎么让一个没有持久记忆的 AI，每次醒来都能快速进入状态、知道自己是誰、知道该干啥。

八个配置文件的第一性原理

让一个没有持久记忆的 AI，每次醒来都能快速成为「确定的某个人」。

所有设计都围绕这个来的。

这套系统的意义不是「配置」，是「养成」。你投入多少思考，它就会变成几分像你。

最后

如果你也在用 OpenClaw，不妨从这八个文件开始，给你的 AI 写一份「分身使用手册」。

不需要一次写完，一点一点来——这本身就是我们和AI共同成长的过程。

关键是：把OpenClaw当成「另一个自己」来养，不是当成工具来配。

工具是别人的，灵魂是自己的。