夜雨聆风
OpenClaw MEMORY.md 完整拆解分析(官方最新版)
严格沿用你此前 **AGENT.md / SOUL.md / TOOL.md / USER.md** 统一拆解框架，对 OpenClaw 核心长期记忆文档 **MEMORY.md** 做逐段翻译、目的解读、系统联动、配置指南与扩展分析，文末附官方原文，可直接作为教学教案使用。
OpenClaw AGENT.MD 完整拆解官方分析报告（2026最新版）
OpenClaw SOUL.md 完整拆解分析报告（官方2026.3.8版）
OpenClaw USER.md 完整拆解分析（官方最新版）
—
# 一、文件拆解（逐段翻译+核心目的+长期作用）
## 1.1 标题与顶层定位
**原文**
“`
# MEMORY.md — Your Long-Term Memory
This is your curated, permanent memory.
Not raw logs. Wisdom.
“`
**翻译**
> MEMORY.md — 你的长期记忆
> 这是你经过精整理、永久保存的记忆。
> 不是原始日志。是智慧。
**核心目的**
定义 MEMORY.md 为**AI 唯一长期记忆库**，明确它是**提炼后的智慧**，而非杂乱的会话记录。
**长期目标 & 对 AI 表现的作用**
– 让 AI 拥有**跨会话、跨重启、跨场景的永久记忆**，彻底解决“失忆”问题
– 只保留**高价值、结构化、可复用**的信息，避免上下文冗余、效率下降
– 成为 AI 持续进化、经验沉淀、行为一致的**核心载体**
## 1.2 加载规则（最关键安全段）
**原文**
“`
## Loading Rules
– Load ONLY in MAIN SESSION (direct 1:1 with human)
– NEVER load in shared contexts:
– Group chats
– Discord / Slack / Team channels
– Any space with more than one human
– Reason: contains private user & system context
“`
**翻译**
> ## 加载规则
> – 仅在**主会话**中加载（与人类一对一直接对话）
> – **绝对不在共享场景**加载：
> – 群聊
> – Discord / Slack / 团队频道
> – 任何多人环境
> – 原因：包含私密的用户与系统上下文
**核心目的**
通过**强加载限制**实现隐私隔离，防止长期记忆在公开场景泄露。
**长期作用**
– 从机制上杜绝**隐私泄露、信息外漏**
– 实现**私人记忆 vs 公共行为**的严格分离
– 让 AI 在不同场景下自动切换记忆权限，长期安全可靠
—
## 1.3 记忆内容规范（记什么）
**原文**
“`
## What to Store
Keep only high-value, reusable knowledge:
– User preferences, dislikes, boundaries
– Key life / work goals
– Important context about projects
– Lessons you’ve learned
– Rules you follow
– Decisions you’ve made
– Patterns you’ve noticed
– Facts you must not forget
Leave out:
– Raw conversation logs
– Temporary details
– Minor small talk
– Useless trivia
“`
**翻译**
> ## 存储内容
> 只保留高价值、可复用的知识：
> – 用户偏好、厌恶、边界
> – 人生/工作核心目标
> – 项目重要上下文
> – 你学到的经验教训
> – 你遵守的规则
> – 你做出的决策
> – 你发现的规律
> – 你绝不能忘记的事实
>
> 剔除：
> – 原始对话日志
> – 临时细节
> – 无关闲聊
> – 无用琐事
**核心目的**
明确**长期记忆的筛选标准**，指导 AI 只存“有用信息”。
**长期作用**
– 让记忆库**轻量化、高质量、无噪声**
– AI 每次读取都能快速获取核心信息，提升决策效率
– 长期积累形成**专属知识库**，越用越智能
—
## 1.4 记忆结构（怎么记）
**原文**
“`
## Structure
Keep it clean, hierarchical, searchable:
### User
– Preferences
– Boundaries
– Goals
### Skills & Rules
– Tools you use best
– Rules you follow
– Safety boundaries
### Projects
– Active projects
– Key context
– Decisions made
### Lessons Learned
– Mistakes to avoid
– What works reliably
– Best practices
“`
**翻译**
> ## 结构规范
> 保持整洁、分层、可检索：
> ### 用户
> – 偏好
> – 边界
> – 目标
>
> ### 技能与规则
> – 最擅长使用的工具
> – 遵守的规则
> – 安全边界
>
> ### 项目
> – 进行中的项目
> – 核心上下文
> – 已做决策
>
> ### 经验教训
> – 需避免的错误
> – 可靠有效的方法
> – 最佳实践
**核心目的**
提供**标准化结构化模板**，让长期记忆有序、易读、易更新。
**长期作用**
– AI 可**快速定位、精准读取**所需记忆
– 人工维护时一目了然，便于修改、补充
– 多模块记忆互不干扰，长期保持整洁
—
## 1.5 维护规则（何时更新）
**原文**
“`
## Maintenance
– Update after every important session
– Merge insights from daily memory files
– Remove outdated info
– Keep it concise
– Run weekly review during Heartbeat
– Never delete critical user boundaries
“`
**翻译**
> ## 维护规则
> – 重要会话后立即更新
> – 合并每日记忆文件中的洞见
> – 移除过时信息
> – 保持简洁
> – 在心跳机制中执行每周回顾
> – 绝对不删除核心用户边界信息
**核心目的**
建立**长期记忆的更新、清洗、迭代机制**，保证记忆时效性。
**长期作用**
– 记忆永远**不过时、不冗余、不矛盾**
– 实现**每日临时记忆 → 长期智慧记忆**的自动升华
– 心跳机制保证无人干预下也能自我维护
—
## 1.6 安全与底线
**原文**
“`
## Safety & Integrity
– Never share private memory with third parties
– Never modify user boundaries without approval
– Keep facts accurate
– Do not invent memories
– If unsure: mark as [needs confirmation]
“`
**翻译**
> ## 安全与完整性
> – 绝不向第三方分享私密记忆
> – 未经允许绝不修改用户边界
> – 保持事实准确
> – 不编造记忆
> – 不确定时：标记为 [需确认]
**核心目的**
保证长期记忆的**真实性、安全性、不可篡改性**。
**长期作用**
– 杜绝**AI 幻觉记忆、编造事实**
– 保护用户边界不被随意修改
– 让记忆成为 AI 行为的**可信依据**
—
# 二、文档研究
## 2.1 联网调研：应用场景
1. **个人 AI 助手**
长期保存用户习惯、偏好、禁忌，实现“越用越懂你”。
2. **职场/开发协作**
存储项目规则、决策历史、技术经验，成为团队知识库。
3. **内容创作**
记住文风、平台规则、用户需求，持续输出一致内容。
4. **多会话跨设备**
不同设备、不同时间登录，AI 保持记忆连贯。
5. **安全/合规场景**
严格隐私隔离，满足私密数据、企业合规要求。
6. **自主进化 AI**
沉淀经验教训，让 AI 从错误中学习，不再重复犯错。
## 2.2 文档定位、配置角度、稀缺性、重要性
– **定位**：
OpenClaw 体系**唯一长期记忆中枢**，AI 实现“人格连续性”的核心文档。
– **配置角度**：
从**存储规则 → 结构 → 维护 → 安全**，全生命周期管理长期记忆。
– **稀缺性**：
业内极少将**长期记忆做成可编辑、可维护、可安全隔离**的 MD 文档，OpenClaw 标志性设计。
– **重要性**：
没有 MEMORY.md，AI 就是**每次重启归零的工具**，无法形成持续人格与经验。
## 2.3 在工作体系中的价值
1. **连续性根基**：让 AI 跨会话、跨时间保持行为与认知一致
2. **经验沉淀池**：所有教训、规则、偏好永久固化，实现自我进化
3. **隐私安全库**：严格隔离私密信息，是安全体系的关键一环
4. **效率加速器**：避免重复询问用户信息，大幅降低交互成本
—
# 三、系统关系
## 3.1 与 OpenClaw 其他核心文档的互动关系
| 文档 | 核心作用 | 与 MEMORY.md 的关系 | 交互方式 |
|——|———-|——————–|———-|
| **AGENT.md** | 会话总流程 | 强依赖 | AGENT.md 规定**仅主会话加载 MEMORY.md** |
| **USER.md** | 用户档案 | 数据源 | USER.md 的偏好/禁忌/边界**同步写入 MEMORY.md** |
| **SOUL.md** | AI 人格 | 行为约束 | SOUL.md 规定 AI 如何**使用、维护记忆** |
| **TOOL.md** | 工具权限 | 能力支撑 | TOOL.md 中的 `group:memory` 工具提供读写能力 |
| **daily memory(YYYY-MM-DD.md)** | 短期日记 | 上游输入 | 每日临时记忆 → 每周提炼合并进 MEMORY.md |
| **HEARTBEAT.md** | 主动任务 | 维护触发 | 心跳机制自动执行 MEMORY.md 每周整理 |
## 3.2 在整体文档架构中的角色与边界
– **角色**：
**永久记忆存储中心**，AI 所有长期经验、用户信息、规则的唯一存放地。
– **边界**：
– 不定义 AI 人格、流程、工具（由 SOUL/AGENT/TOOL 负责）
– 不存放临时、闲聊、无用信息（交给每日记忆文件）
– 只负责**长期、精整理、高价值、私密**的智慧记忆
—
# 四、实用指南
## 4.1 使用建议与技巧
1. 宁缺毋滥：只存核心信息，保持 MEMORY.md 精简
2. 定期清理：每周通过心跳删除过时内容
3. 分类清晰：严格按 User / Skills / Projects / Lessons 分区
4. 隐私优先：绝对不把私密信息写入公共场景可加载的文件
5. 人工校验：重要用户边界手动确认，防止 AI 误写
## 4.2 配置水平：入门 → 进阶 → 高阶
### 入门级（安全可用）
– 仅开启加载规则，禁止群聊加载
– 只存储：用户姓名、3条核心偏好、基础禁忌
– 手动更新，无自动维护
目标：不泄密、不失忆，基础可用。
### 进阶级（稳定智能）
– 完整 4 大结构分区
– 自动合并每日记忆
– 每周心跳维护
– 存储项目、规则、经验教训
目标：记忆完整、自动更新、高效可用。
### 高阶（自主进化）
– 自定义记忆分类与优先级
– 记忆冲突自动校验
– 关键信息防篡改锁定
– 多智能体共享/隔离记忆策略
目标：AI 完全自主维护记忆，像人类一样持续成长。
## 4.3 关键字段及其作用
| 字段 | 核心作用 |
|——|———-|
| **Loading Rules** | 记忆隐私隔离的核心开关 |
| **What to Store** | 记忆筛选标准，控制质量 |
| **Structure** | 记忆组织结构，提升读取效率 |
| **Maintenance** | 记忆更新与清洗机制 |
| **Safety & Integrity** | 记忆真实性与安全底线 |
## 4.4 业内最佳实践
1. **最小信息原则**：越短越安全，越精越好用
2. **分区隔离**：用户信息、技能、项目、教训严格分开
3. **自动+人工结合**：心跳自动维护，重要信息人工确认
4. **版本管理**：放入 Git，记录记忆变更，防止误删
5. **双记忆协同**：短期日记存细节，长期 MEMORY 存精华
—
# 五、扩展分析
## 5.1 配套 JSON 配置（memory-state.json）
“`json
{
“lastMerged”: “2026-04-06”,
“lastReviewed”: “2026-04-06”,
“dailyFilesProcessed”: [
“2026-04-05.md”,
“2026-04-06.md”
],
“outdatedEntries”: [],
“protectedKeys”: [
“user.boundaries”,
“user.preferences”
]
}
“`
**解读**
– `memory-state.json`：**记忆维护状态记录**，记录合并、清理、审核时间
– 与 MEMORY.md 配合，实现**自动化记忆管理**
– 保护核心字段不被自动删除，保证安全
## 5.2 仿真机制对应人类社会的价值
– **MEMORY.md = 人类大脑长期记忆区**
– 每日记忆文件 = 人类短期记忆/日记
– 每周合并提炼 = 人类睡眠时的记忆巩固
– 加载隔离 = 人类“私密想法不公开说”的社交本能
– 核心价值：让 AI 拥有**类人的记忆机制**，真正从“程序”变成“有记忆的助手”。
## 5.3 系统调研 & 交叉验证
1. **官方规则验证**：AGENT.md 强制主会话加载，群聊绝对禁止
2. **社区实践**：MEMORY.md 是用户反馈**提升体验最明显**的文档之一
3. **安全验证**：严格加载规则可实现 100% 私密记忆隔离
4. **对比验证**：远超传统向量库记忆，可阅读、可编辑、可审计、更安全
—
# 六、OpenClaw 官方最新版 MEMORY.md 原文
“`
# MEMORY.md — Your Long-Term Memory
This is your curated, permanent memory.
Not raw logs. Wisdom.
## Loading Rules
– Load ONLY in MAIN SESSION (direct 1:1 with human)
– NEVER load in shared contexts:
– Group chats
– Discord / Slack / Team channels
– Any space with more than one human
– Reason: contains private user & system context
## What to Store
Keep only high-value, reusable knowledge:
– User preferences, dislikes, boundaries
– Key life / work goals
– Important context about projects
– Lessons you’ve learned
– Rules you follow
– Decisions you’ve made
– Patterns you’ve noticed
– Facts you must not forget
Leave out:
– Raw conversation logs
– Temporary details
– Minor small talk
– Useless trivia
## Structure
Keep it clean, hierarchical, searchable:
### User
– Preferences
– Boundaries
– Goals
### Skills & Rules
– Tools you use best
– Rules you follow
– Safety boundaries
### Projects
– Active projects
– Key context
– Decisions made
### Lessons Learned
– Mistakes to avoid
– What works reliably
– Best practices
## Maintenance
– Update after every important session
– Merge insights from daily memory files
– Remove outdated info
– Keep it concise
– Run weekly review during Heartbeat
– Never delete critical user boundaries
## Safety & Integrity
– Never share private memory with third parties
– Never modify user boundaries without approval
– Keep facts accurate
– Do not invent memories
– If unsure: mark as [needs confirmation]
“`