OpenClaw拆解(二):文件即大脑,剖析OpenClaw的“灵魂”注入与持久化设计

本系列的第二篇姗姗来迟。

虽然我预测OpenClaw的热潮可能会逐渐散去，但它的设计确实是值得学习的，研究清楚了它的设计思路，就会发现它也没有什么护城河，如果不嫌麻烦，你我也可以基于Pi-AI手撸一个自己的OpenClaw。(它的代码也是基于Pi Vibe Coding的，代码质量深受诟病)

也许后面会有很多大厂推出自己的XClaw，但这个领域第一个吃螃蟹的先行者永远是值得尊敬的。

一、上下文限制和持久化记忆的难题

如果你深度使用AI工具，或者使用AI Coding解决过大型项目，你一定对下面的现象不陌生：

AI不像一个熟悉了解你的私人助理，每次重新跟它对话，它都像是一个陌生人
你花了一个下午的时间给AI喂了几十页的项目需求、方案、待解决的问题等资料，换了一个对话解决另一个棘手问题的时候，或者触发了某些AI IDE自动压缩上下文窗口的红线时，AI关于你项目和现状的所有认知瞬间灰飞烟灭了

面对这个“熟悉的陌生人”，你必须重写Prompt，重新解释你的项目信息。

这种“断裂感”是AI模型的上下文限制导致AI助理无法沉淀为数字资产的核心痛点之一。

在上一篇里提到过，OpenClaw的出现，一方面是解放了交互方式，可以通过手机IM远程操作云端工作，另一方面就是终结了这种“临时工”模式。它的核心设计哲学我理解就是：放弃云端黑盒数据库，回归本地Markdown文件。

通过IDENTITY、SOUL、AGENTS、MEMORY和HEARTBEAT等核心文件，OpenClaw为AI注入了可积累、可执行、可遗传的DNA。

这篇文章就主要针对这几个文件剖析一下它的设计思路和运行流程。

二、核心设计思想：五个核心文件

从上图可以看出，其实一共有八个核心文件，有几个比较简单的就不过多展开了，包括：

1. USER.md

该文件用来表明用户是谁，应该如何称呼他们；每次对话的时候都会加载

2. TOOLS.md

这个文件其实很重要，它定义了OpenClaw可以使用的工具。主要是关于本地工具的定义和约定说明。它依据该文件描述使用工具。有点skills的感觉。

3. BOOTSTRAP.md

这个文件只在首次运行时生效一次，仅为全新的工作区创建使用。启动仪式完成后即被自动删除。

接下来就详细剖析一下剩下来的五大核心文件。

1. IDENTITY & SOUL

这俩文件是注入灵魂的锚点，其设计思路为：普通的system prompt往往被塞在代码里或者隐藏在Web UI后，随着对话加深，LLM会产生“性格漂移”，影响指令遵循。OpenClaw将其剥离并分为了两个维度：

IDENTITY.md解决“我是谁”：定义职能边界(例如：一人公司的AI负责人)，这解决了你在跟AI对话时，它一会儿自称小A一会儿自称小B，一会儿是产品经理一会儿是资深研发的割裂感。稳定的角色才是一个合格的AI私人助理。
SOUL.md解决“我是什么性格”：定义价值观基准(例如：拒绝虚伪的情绪价值，追求极致的信噪比)，比如我是这么定义的(不需要你手改，你直接跟你的龙虾说即可)：

使用流程：这是每轮对话的“强制前置过滤器”。每当发送一条消息时，OpenClaw Gateway都会先去阅读这两个文件。这保证了AI的反馈始终锚定在你的设定上，不会因为聊得太久就变得客套或者平庸。

2. AGENTS

这个文件是定义角色分层，OpenClaw提供了子智能体的概念，这个文件是它的技术底座。它的设计思路：让一个LLM同时扮演架构师、程序员、产品经理和营销专家，往往会导致各角色能力都很平庸，LLM不擅长在各个不同角色间“闪转腾挪”，最终就是给出一堆废话。

以我的“数字内阁”举例，我在该文件里定义了一套组织架构：

通过配置CTO、CPO、COO等多个子Agent逻辑补丁，我可以将复杂的商业决策拆解为内部的多方博弈。

运行流程：

当主Agent接到复杂指令时，它会像一个主持人一样，自动调度文件中预设的专家角色进行内部评审。这种玩法让AI具备了自我博弈能力，避免单一角色AI”献媚式复读“。我看到有些人用多个OpenClaw来扮演这种多角色组织架构的玩法，那种玩法成本过高，适合富资本大佬。

3. MEMORY

这个文件是决定了AI可以跨越时空，做到”持久认知“的关键。它的设计思路是：上下文受限是吧？多轮对话上下文超限会丢上下文是吧？那我给你存起来不得了。

它建立了一个”读取-回写“的回环。原来AI只有缓存，现在有了硬盘了。

MEMORY不是一个文件，每个独立的任务或者日期都可能会回写为记忆文档：

比如这个文档记录了我跟”Z总管“最初的聊天内容：

使用流程：

语义检索：当你问起旧事，AI会根据你的关键词，在memory/*.md日志中进行语义搜索，把几周前的结论瞬间加载进当前的上下文。
增量沉淀：会话结束或者触发剪枝时，AI会将今日生成的有效认知、决策点等，增量写入Markdown文件爱你。这意味着，你的文件系统就是AI的突触，它会随着对话不断生长。这种甚至能记得很久以前的聊天的AI助理，确实会给人不一样的感觉。

4. HEARTBEAT

这个文件能够打破提问-回答的主动循环，它可以在背后做一些定时任务和监控类的任务。

这就区别于其他的LLM产品了：你不说话，它就是死的。OpenClaw通过Heartbeat.md赋予了AI时间感和主动权。

作为一个私人助理，你应该可以做到布置一个任务，它就默默去做了，当有结果时再主动反馈给你。

使用流程：它像一个定时监控器，即使你下班了，小龙虾的网关也会根据这个文件里定义的逻辑，在后台准时执行。

比如我的Heartbeat.md：

美伊战争期间，我想关注一下BNO原油的趋势辅助决策，我就给它下了一个大盘监控任务。

再贴一下整体的事件流转期间，这几个核心文件的生命周期图如下：

这里还有一个小tips，既然不担心上下文丢失了，在解决某个新的问题时，建议使用/reset重置对话上下文。不必担心AI失忆，在必要时它会读取持久化的memory文档寻回之前的记忆。好处则是减少了本次对话的上下文，解决问题更聚焦效果可能更好。

三、结语

写到这里长度差不多了，已经2000多字了，标题里提到的“文件即大脑”，为什么使用Markdown文件来进行设计还没有提到，看来还得再加一篇。

作为有志于深入使用和研究AI，利用AI助力自己成长的人来说，学习OpenClaw的设计和工程化手段还是很有必要的。它做得最了不起的一件事就是让AI助理从一个“陪聊软件”进化成了一个“资产管理系统”。它让每一次对话都变成了数字财富的复利。当你的“memory/”目录里堆满了成百上千篇业务逻辑和技术决策，你拥有的就不再是一个工具，而是一个真正懂你、永不疲倦的“合伙人”。