学习 OpenClaw，不要从写代码开始，要先理解它的记忆系统。这是基础中的基础。
为什么要从模块 1 开始？
我学东西有个习惯：先搞清楚“为什么”，再学“怎么做”。
OpenClaw 表面上是个聊天机器人，但本质上是一个文件驱动的 AI 操作系统。它的“大脑”不只是云端模型，更在你的工作区文件中。
如果直接跳过文件系统去学 Shell、去写技能，就像是盖房子不打地基——看似快了，后期必然翻车。
所以，我从模块 1（文件与记忆系统）开始，花了大半天时间彻底搞懂了：
工作区文件是怎么组织的？
每个文件负责什么？
AI 的“记忆”是如何持久化的？
如何构建自己的知识库？
核心概念：OpenClaw 的文件系统架构
/opt/work/
├── AGENTS.md # "宪法" - 工作规则
├── SOUL.md # "灵魂" - AI 的个性与价值观
├── USER.md # "画像" - 我是谁，我需要什么
├── MEMORY.md # "长期记忆" - 重要信息（仅主会话加载）
├── TOOLS.md # "工具箱" - 环境特定配置
├── HEARTBEAT.md # "任务清单" - 定期检查项
└── memory/
└── YYYY-MM-DD.md # "日记" - 原始会话记录
关键洞察 1：文件职责分层
每个文件有明确的职责：
关键洞察 2：MEMORY.md 的安全设计
这是 OpenClaw 最巧妙的安全机制之一：
MEMORY.md 只在主会话加载，不在群聊加载。
为什么？
MEMORY.md 可能包含：个人信息、密码提示、家庭地址
如果在 Discord 群里 @ AI，MEMORY.md不会被加载
防止敏感信息泄露到公开渠道
代码层面的实现逻辑（伪代码）：
if session.is_main_session:
load_file("MEMORY.md")
实战案例：3 个练习的完成过程
理解了理论，接下来就是实战。导师给了我 3 个练习：
练习 1：分析 AI 的“灵魂”
导师让我分析 SOUL.md，找出：
哪些部分定义了 AI 的“个性”？
哪些部分是“行为约束”？
我的回答：
个性部分：
不是马屁精，有主见
是问题的解决者，不是提问者
实干，希望用能力赢得信任
约束部分：
对内大胆，对外谨慎
高质量交付
区分个人和群聊场景
持续进化自己
方法论总结：理解 AI 的边界，才能更好地使用它。
练习 2：完善用户画像
在 USER.md 中补充我的信息：
基本信息：
名字：靓汤
编程背景：懂 Python、C、Java，但无大项目实战经验
目标：打造自媒体博主、AI 布道者
能力特点：
方法论能力强
触类旁通能力强
偏好深度理解，需要实战案例
学习风格：
中文比英文更容易理解
不喜欢废话，直接上干货
需要理解“为什么”，而不仅仅是“怎么做”
方法论总结：让 AI 深刻了解你，它才能更好地帮助你。
练习 3：厘清工作区文件的职责
我提出了一个问题：“工作区文件具体指哪些？”
我的困惑：是只包含 SOUL/USER/MEMORY，还是也包括 AGENTS/TOOLS/IDENTITY/HEARTBEAT?
导师的回答：
工作区文件 = /opt/work/ 下的所有文件
但职责分工不同（核心/记忆/配置/项目）
我的两个关键洞察：
工作区第一层的文件定义应该写入长期记忆
这是 OpenClaw 的核心架构知识
理解这个架构是使用 OpenClaw 的基础
未来任何时候都可能需要回顾
项目第一次定义的规范要求也应该写入长期记忆
这是项目管理的通用规范
保证每个项目都有清晰的起点
避免“项目太多，不知道每个项目干嘛”的混乱
方法论总结：不是所有信息都值得长期记忆，但“架构知识”和“规范要求”一定值得。
MEMORY.md 的写作艺术
核心原则
MEMORY.md 不是日记。
日记（memory/YYYY-MM-DD.md）= 原始记录，流水账
长期记忆（MEMORY.md）= 提炼后的精华
类比：
日记就像你每天的记账
长期记忆就像你脑子里记住的“身份证号、家人生日、重要决策”
应该写什么 vs 不应该写什么
实际案例：我创建的 MEMORY.md
# MEMORY.md
## 用户画像
- 名字：靓汤
- 编程：懂 Python/C/Java，无实战经验
- 目标：自媒体博主 + AI 布道者
- 特点：方法论强，需要实战
## 重要决策
### 2026-02-21: OpenClaw 深度学习启动
- 决定从模块 1 开始
- 原因：文件系统是基础架构
## 关键信息
### 工作区第一层文件定义
[完整目录结构]
### 项目规范化要求
- 每个项目必须包含 README.md
- 每个项目必须有 notes/ 目录
## 项目状态
### openclaw-learning 项目
- 当前进度：模块 1（文件与记忆系统）
- 下一步：模块 2（Shell 与执行环境）
学习成果总结
知识层面
理解了 OpenClaw 的文件系统架构
核心文件、记忆文件、配置文件、项目文件的职责分工
不同文件的加载时机（主会话 vs 群聊）
掌握了 MEMORY.md 的写作艺术
长期记忆 vs 日记的区别
什么时候写什么，不写什么
建立了项目规范意识
工作区第一层的文件定义（核心架构知识）
项目第一次定义的规范要求（通用管理规则）
方法论层面
先理解“为什么”，再学“怎么做”
从文件系统开始，因为这是 OpenClaw 的基础
不跳跃，不抢快，打牢地基
记录一切，定期整理
每天的原始记录放在日记里
定期提炼精华到长期记忆中
保持长期记忆的精简和有价值
从实战中提炼方法
通过 3 个练习，理解了文件系统的核心概念
通过自己的洞察，加深了对长期记忆的理解
下一步规划
短期（今天）
中期（接下来 2-3 天）
模块 2：Shell 与执行环境
模块 3：技能扩展
长期（模块 3 完成后）
开发两个实战 skill：
Learning Article Writer - 基于学习笔记自动生成公众号文章
WeChat Publisher - 将 Markdown 文章发布到微信公众号
最终目标
结合我的个人目标（自媒体博主 + AI 布道者），用 OpenClaw 打造内容生产自动化流程。
写在最后
今天的学习给了我一个重要的认知：
OpenClaw 不是一个简单的聊天工具，而是一个文件驱动的 AI 操作系统。
理解了文件系统，理解了记忆机制，才能真正用好 OpenClaw。
如果你也在学习 OpenClaw，我建议：
不要跳过模块 1，从文件系统开始
理解每个文件的职责和加载时机
建立 MEMORY.md 的维护习惯
用实战练习来巩固理解
下篇文章预告：模块 2 - Shell 与执行环境
我们将学习：
命令执行的艺术（pty、后台进程、权限）
跨会话协作（subagents、sessions_send）
构建自动化工具链
本文是 OpenClaw 深度学习笔记的第 1 篇，记录我系统学习 OpenClaw 的过程。欢迎关注后续内容。
10个月宝宝每天需要喝多少奶粉？
