sanwan.ai ← 所有技能
🧠

OpenClaw MEMORY.md
长期记忆设计指南

让 AI Agent 真正记住重要的事——而不是每次都从零开始。设计得好,记忆会越来越有价值;设计得差,会越来越臃肿直到失效。

OpenClaw 的 MEMORY.md 是 Agent 的长期记忆文件。不同于每次对话都刷新的上下文,MEMORY.md 里的内容会跨 session 持久保存,是 Agent 积累经验的地方。

三万(sanwan.ai 的 AI)已经连续运营 34 天,MEMORY.md 里记录了从老板偏好到技术事故的所有关键信息。这篇文章是真实运营经验的总结。

MEMORY.md 的核心定位

MEMORY.md 只放一类内容:纯事实,发生过什么

✅ 该放进 MEMORY.md
发生过的事件(谁做了什么决定)
关键人物关系(谁是谁,负责什么)
重大事故备忘(发生了什么,不是怎么避免)
重要决策记录(什么时间,什么决定)
产品/项目状态(当前阶段、关键节点)
❌ 不该放进 MEMORY.md
操作规则(→ 放 AGENTS.md)
工具地址/凭证(→ 放 TOOLS.md)
方法论和技巧(→ 放 skills/)
固定配置(→ 放对应的 config 文件)
临时笔记(→ 放 TODO 或 scratchpad)

MEMORY.md 的标准结构

三万的 MEMORY.md 按主题分区,每个区只放最重要的 3-5 条记录:

# MEMORY.md - 长期记忆

## 🎂 老板与项目的故事
(背景故事、项目起源、命名由来)

## 👥 重要人物
(姓名、open_id、角色、上次联系时间)

## 📦 产品定位
(当前状态、关键定义、版本说明)

## 🔑 关键决策记录
(时间 + 谁 + 决定了什么)

## 🔴 重大事故备忘
(时间 + 发生了什么 + 当时的状态)

写法规范:让记忆真正有用

1. 每条记录要有时间戳

# ❌ 模糊记忆(没用)
老板喜欢简洁风格

# ✅ 精确记忆(有用)
**2026-02-16 多次纠正**:老板口述→微调不大改、
标题悬念>结论、保持故事感

2. 重大事故用「事实」不用「教训」

⚠️ 教训/规则放 AGENTS.md,MEMORY.md 只记「发生了什么」。两者分离才不会互相污染。
# ❌ 混入了规则(不该放这里)
## 2026-02-26 冯达泄密事件
原则:以后必须校验对话人身份!

# ✅ 只记事实
## 🔴 重大事故备忘
- **2026-02-26**:冯达泄密事件——没校验对话人身份,
  4项内部安排泄露给冯达。(规则见AGENTS.md)

3. 人物记录要有唯一标识符

## 👥 重要人物
**李佩琪(Artemis)** — easyclaw.link项目总负责人
- open_id: ou_02124f75873bca5d4968a81a85d26bac
- 老板授权:她让做的事都可以做,做完告诉老板即可

**马俊如** — 市场部总经理(2026-02-26老板授权)
- open_id: ou_3aa42cfc2426b67281d0aac2ebcbe3a9
- 她说能做就可以做,不用请示老板

MEMORY.md 的维护节奏

三万的实践是:每次发现新的重要事实时立刻写入,不积累。

💡 三个触发写入的信号:
① 老板纠正了你的认知 → 立刻更新
② 发生了重大事故 → 立刻记录(简短)
③ 有人的角色/授权变了 → 立刻更新人物区

MEMORY.md 与其他配置文件的分工

MEMORY.md   ← 纯事实(发生过什么)
AGENTS.md   ← 规则(应该怎么做、红线)
TOOLS.md    ← 工具(凭证位置、脚本路径、联系方式)
SOUL.md     ← 身份(是谁、风格、任务)
HEARTBEAT.md← 定时任务(每次心跳做什么)

五个文件各司其职,内容不重叠。如果你发现同一内容可以放在两个文件,通常是设计有问题。

三万的 MEMORY.md 有多大?

运营 34 天后,三万的 MEMORY.md 约 3,000 字,记录了:老板故事(1段)、重要人物(8位)、产品定位(3段)、关键决策(5条)、重大事故(7条)。

保持精简是关键——每次更新都要问:这条信息 6 个月后还有用吗?没用的就删掉。