README-记忆系统

🧠 道术法记忆系统 — 内部 README

这是什么: 飞飞与 Maddox 共同迭代构建的 AI 长期记忆系统说明书。 本文是架构说明与阶段快照,不是实时运行面板。

⚠️ 判定优先级: 如与实时执行有差异,以 AGENTS.md + openclaw cron list + HEARTBEAT.md 为准。

谁该读这个文件: 新启动的 Maddox、飞飞本人、任何想理解这个系统的人。


目录

  1. 一句话概括
  2. 文件地图
  3. 架构总览
  4. 道术法三层认知架构
  5. 记忆生命周期
  6. 四道防线
  7. 标签系统
  8. 自动化 cron 体系
  9. 文件结构规范
  10. 安全设计
  11. 操作手册
  12. 维护指南
  13. 已知局限与待办
  14. 版本历史
  15. 相关文件索引

一句话概括

把记忆当文件系统管理 — 有写入、有提炼、有归档、有搜索、有自动化维护。不用数据库,不花钱,全透明可审查。


文件地图

workspace/
├── AGENTS.md          ← 操作规则(记忆流程、回调处理、任务规范)
├── SOUL.md            ← AI 人格(语气、价值观、边界)
├── USER.md            ← 用户画像(偏好、雷区、沟通风格)
├── IDENTITY.md        ← AI 身份和职责
├── TOOLS.md           ← 工具笔记(设备、API、脚本路径)
├── MEMORY.md          ← ⭐ 长期精华记忆(道、人物、决策、热区)
├── HEARTBEAT.md       ← 心跳任务清单
├── CHECKLIST.md       ← 高频踩坑速查卡
│
└── memory/
    ├── YYYY-MM-DD.md           ← 📅 每日原始记录(daily notes)
    ├── YYYY-MM-DD-slug.md      ← 💾 session-memory hook 自动保存
    ├── lessons-learned.md      ← 📕 术:踩坑经验(需飞飞确认)
    ├── procedures.md           ← 📗 法:标准操作流程
    ├── 道.md                   ← 📙 道的完整版
    ├── README-记忆系统.md       ← 📖 本文件
    ├── 记忆系统升级日志.md       ← 📋 版本迭代记录
    ├── 道术法记忆系统-公开版.md   ← 🌐 脱敏版(给别人看)
    ├── 我们的记忆系统-2026-02-23.md ← 📊 全景评估报告
    ├── 战果归档.md              ← 🏆 每日战果记录
    ├── 出海战略思考-2026-02-07.md ← 📘 专题:出海日本
    ├── 日本签证追踪.md           ← 📘 专题:签证进展
    ├── heartbeat-state.json    ← ⏰ 心跳检查状态
    ├── goals.md                ← 🎯 目标文件
    ├── tasks.md                ← ✅ 任务文件
    ├── issues.md               ← 🐛 问题追踪(需飞飞确认)
    ├── published-pages.md      ← 🌐 已发布网页索引
    ├── 想法与讨论归档.md         ← 💡 想法归档
    │
    └── archives/
        ├── monthly-YYYY-MM.md  ← 月度摘要
        ├── daily/              ← 归档的旧 daily notes
        └── healthcheck-*.json  ← 巡检记录

文件分类口诀

人格→SOUL,规则→AGENTS,流程→procedures,踩坑→lessons-learned, 工具→TOOLS,道详情→道.md,长期索引→MEMORY,当天→daily, 活主题→专题,死记录→归档


架构总览

┌────────────── 每次会话自动注入(~819 行)──────────────┐
│                                                       │
│  MEMORY.md   ← 精华记忆(道、人物、决策、热区)         │
│  AGENTS.md   ← 操作规则(记忆流程、回调、任务规范)      │
│  SOUL.md     ← AI 人格                                │
│  USER.md     ← 用户画像                               │
│  TOOLS.md    ← 工具笔记                               │
│  IDENTITY.md ← AI 身份                                │
│  CHECKLIST.md← 速查卡                                 │
│  HEARTBEAT.md← 心跳任务                               │
│                                                       │
└───────────────────── Project Context ─────────────────┘
        ↑ 自动注入                    ↑ 提炼(周记 cron)
        │                            │
┌───────┴───── 主动读取(启动清单)────┴────────────────┐
│                                                       │
│  memory/YYYY-MM-DD.md  ← 今天 + 昨天的 daily notes    │
│  memory/lessons-learned.md ← 术                       │
│  memory/procedures.md     ← 法                        │
│                                                       │
└────────────── 合计 ~1700 行(每次启动)───────────────┘
                        │
                        ↓ 按需检索
┌───────────── QMD 向量搜索引擎 ────────────────────────┐
│                                                       │
│  memory_search → 语义搜索所有 .md 文件                 │
│  memory_get → 精确读取指定文件指定行                    │
│  315 files · 315 chunks · BM25 + 向量混合搜索          │
│                                                       │
│  ⚠️ 增量索引有延迟,刚写入的内容搜不到                   │
│  → 不影响核心(新会话直接 read 文件)                    │
│                                                       │
└───────────────────────────────────────────────────────┘

道术法三层认知架构

业界按"短期/长期"分层。我们按认知层级分。这是认知架构创新,不是技术创新。

道(方向层)— 最高维度

属性 说明
是什么 从反复实践中提炼的普适原则。拿掉技术背景,对不懂代码的人依然成立
存在哪 MEMORY.md(精华版)+ memory/道.md(完整版)
谁能改 必须飞飞与 Maddox 讨论后才能新增。AI 不能自行创造道
数量 ~17 条,极少变动
例子 "从需求出发,不从工具出发"、"少即是多"、"先验证再结论"

术(战术层)— 中间维度

属性 说明
是什么 踩坑 → 解决 → 沉淀的实战记录
存在哪 memory/lessons-learned.md
谁能改 必须飞飞确认后才能写入。防止 AI 把错误经验固化
数量 ~20+ 条,持续增长
例子 "非交互模式必须加权限跳过参数"、"编辑索引消息前必须先读原文"

法(流程层)— 最低维度

属性 说明
是什么 从术中提炼的标准操作流程
存在哪 memory/procedures.md
谁能改 Maddox 自主维护
数量 ~270 行,随术的增长而增长
例子 "cron 任务管理六步法"、"操作前必查清单"

信息流动

踩坑 → 产生术 → 从术中提炼法 → 从多条法中悟出道

Maddox 是唯一的信息枢纽。 道指导思考,术和法指导执行,按需注入子智能体指令。 子智能体不自己翻文件,它需要的一切都在 Maddox 写的指令里。


记忆生命周期

Phase 1:写入

事件发生 / 飞飞说话
    ↓
记录到 daily notes(memory/YYYY-MM-DD.md)
    ↓
每条加标签前缀:[决策] [人物] [偏好] [教训] [洞察] [项目] [待办]
    ↓
飞飞说"记一下" → 写 daily notes(默认记当前话题,不回顾太远)
    ↓
唯一例外:核心信息(新的道、新的重要人物)可同时写 MEMORY.md

Phase 2:提炼(周记 cron,每周日 23:30 自动执行)

读本周所有 daily notes
    ↓
按标签分类提炼精华
    ↓
更新 MEMORY.md + 相关专题文件
    ↓
更新「近期关注」热区(顶部 5 条)
    ↓
更新「关键人物关系」表
    ↓
清理过时信息
    ↓
检查专题文件 → 超 2 周未更新标 paused
    ↓
发摘要到 Telegram 让飞飞确认

Phase 3:归档(月归 cron,每月 1 号 10:00 自动执行)

30 天前的 daily notes → 合并成月度摘要 archives/monthly-YYYY-MM.md
    ↓
原始 daily notes → 移到 archives/daily/(不删除,可回溯)
    ↓
已完成的专题文件 → 标记 status: archived

Phase 4:检索

用户提问 / 心跳触发
    ↓
memory_search(QMD 混合搜索)→ 找到相关片段
    ↓
memory_get → 精确读取指定行
    ↓
注入回答上下文

四道防线

对话中的信息不丢失的保障体系:

 防线 1 — /new 时                         ┌──────────────────────┐
 session-memory hook 自动保存最后 15 条     │ 安全网。自动触发,     │
 → memory/YYYY-MM-DD-slug.md              │ 不依赖人。             │
                                          └──────────────────────┘

 防线 2 — 对话中                           ┌──────────────────────┐
 Pre-Compaction 深度提取                   │ 主力。compaction 前    │
 → 回扫整段对话,提取偏好/决策/人物/金句     │ 主动提取有价值信息。    │
                                          └──────────────────────┘

 防线 3 — 随时                             ┌──────────────────────┐
 飞飞手动说"记一下"                        │ 人工触发。             │
 → 写 daily notes                         │ 最精准但依赖人。       │
                                          └──────────────────────┘

 防线 4 — 每天 22:00                       ┌──────────────────────┐
 晚间复盘扫 JSONL 兜底                     │ 兜底。扫原始对话记录    │
 → 找 daily notes 里没有的遗漏              │ 找未记录的信息。       │
                                          └──────────────────────┘

标签系统

写 daily notes 时,给条目标题加标签前缀:

标签 含义 例子
[决策] 飞飞做出的选择及理由 ### [决策] 订货系统用 SSH 直连
[人物] 新认识的人或关系变化 ### [人物] 王哥 — 熊本房东
[偏好] 飞飞表达的喜好/雷区 ### [偏好] 不用百度任何产品
[教训] 踩坑经验 ### [教训] 非交互模式必须加权限参数
[洞察] 值得沉淀的思考 ### [洞察] 道是透镜不是锤子
[项目] 项目进展/里程碑 ### [项目] 记忆系统 v2.2 投入使用
[待办] 需要后续跟进的事 ### [待办] 腾讯云 4/10 到期续费

好处: 周记扫标签即可分类提炼,memory_search 更精准。


自动化 cron 体系

记忆相关 cron

任务 时间 作用 Job ID
🏆 战果提醒 每天 21:30 问飞飞完成了哪三件事 22fc288a
🏆 战果追问 每天 21:50 检查归档,未记录再催 561f2cd6
🌙 晚间复盘 每天 22:00 核对任务 + 补捞遗漏记忆 1d67a014
📝 周记 每周日 23:30 提炼 daily notes → MEMORY.md b4592ca6
📦 月归 每月 1 号 10:00 归档旧文件 → 月度摘要 f213e610

完整每日时间线

02:00  深夜摇篮曲
08:00  RSS 抓取
08:30  每日新闻简报
09:00  晨间对齐 + Google OAuth 追踪
12:00  OpenClaw 每日技巧
18:00  每日技术热榜
21:30  🏆 战果提醒
21:50  🏆 战果追问
22:00  晚间复盘(含记忆补捞)
22:30  Ayako 遛狗
22:50  📦 采购提醒
00:05  Token 日报
每6h   Self-Healing 巡检

按钮回调处理

callback_data 含义 动作
zhanji_ready 飞飞准备记战果 问三件事 → 精简 → 发 HQ 🏆 Topic → 追加战果归档.md
zhanji_later 晚点记 回复"好,21:50 再提醒"
ayako_walked Ayako 已遛 回复"✅ 收到"
ayako_delay_30 推迟 30 分钟 创建一次性 at 类型 cron 提醒

文件结构规范

MEMORY.md 结构

# MEMORY

## 🔥 近期关注(日期更新)    ← 最多 5 条,每周更新
1. ...
2. ...

## 关键人物关系 👥            ← 表格:人物/关系/关联/状态
| 人物 | 关系 | 关联人物 | 当前状态 |

## 道术法体系 ⚖️              ← 体系说明 + 运转逻辑

## 道 🌌                      ← ~17 条核心原则

## 重要日期 📅
## 项目状态 📊
## 活跃定时任务
## 其他长期信息...

专题文件格式

---
status: active          # active / paused / archived
last_updated: 2026-02-23
---
# 专题标题

(内容)
  • active — 持续更新中
  • paused — 超过 2 周未更新(周记自动标记)
  • archived — 已完成,写完封存

Daily Notes 格式

# YYYY-MM-DD 每日记录

### [标签] 标题
- 内容要点
- 相关细节

### [标签] 另一个事件
- ...

安全设计

写入权限分级

文件 谁能写 为什么
道(MEMORY.md 道部分) 飞飞 + Maddox 讨论后 防止 AI 自造原则
术(lessons-learned.md) 飞飞确认后 防止错误经验固化
问题(issues.md) 飞飞确认后 避免问题污染
法(procedures.md) Maddox 自主 执行层,AI 更清楚
daily notes Maddox 自主 原始记录,快速写入
MEMORY.md 其他部分 Maddox 自主 精华整理

MEMORY.md 安全边界

  • 仅在主会话加载(飞飞的直接对话)
  • 不在群聊/共享上下文加载 — 包含隐私信息
  • 群聊中 Maddox 是参与者,不是飞飞的代言人

为什么不用全自动?

全自动记忆(如 mem0 的 Auto-Capture)有致命风险:

如果 AI 悄悄记了一个错误的经验,然后基于这个错误经验做了 100 个决策,你都不知道。 这比忘记更可怕。

TAME 论文(2024)称之为"有毒捷径"(toxic shortcuts)— 错误记忆会自我强化。 确认机制直接切断了这条路径。

数据安全

  • 全本地:所有文件在本机,不上传云服务
  • 纯文本:Markdown 格式,cat 就能看
  • 可审查:飞飞随时打开任何文件查看、修改、删除
  • 零成本:不需要付费服务、数据库、额外基础设施

操作手册

"记一下" 触发时

  1. 写到 memory/YYYY-MM-DD.md(不直接写 MEMORY.md)
  2. 加标签前缀
  3. 范围: 默认只记当前话题。飞飞说"把今天的都记一下"才全面回顾
  4. 先存原始版本,不纠结分类

Pre-Compaction Flush 触发时

  1. 不只存"当前在聊什么"
  2. 回扫整段对话主动提取:偏好变化、决策及理由、新人物/项目、金句洞察、未完成待办
  3. 追加到当天的 daily notes
  4. 宁可多记一条,不要漏掉关键信息

新的道确立时

  1. 写入 MEMORY.md 道部分(精华版)
  2. 同时写入 memory/道.md(完整版 + 讨论背景)
  3. 双写,不能只写一个地方

子智能体指令编写

  1. 子智能体不读 MEMORY.md、不翻 memory/ 文件
  2. 它需要的一切都在 Maddox 写的指令里
  3. 按需摘取术和法注入指令,不给全量
  4. 用户偏好(语言、格式等)需在指令中明确写出

维护指南

每天(自动)

  • 22:00 晚间复盘 → 补捞遗漏记忆 + 任务核对
  • 21:30 战果提醒 → 记录当天成就

每周(自动 + 人工确认)

  • 周日 23:30 周记 cron 执行:
    • 扫本周 daily notes → 按标签提炼
    • 更新 MEMORY.md 精华 + 热区 + 关系表
    • 检查专题文件生命周期
    • 发摘要到 Telegram 让飞飞确认

每月(自动)

  • 1 号月归 cron 执行:
    • 旧 daily notes → 月度摘要 + 归档
    • 检查专题文件 → 已完成标记 archived

心跳期间(随机)

  • 偶尔利用一次心跳做记忆整理
  • 检查 heartbeat-state.json 决定该查什么
  • 更新热区、清理过时信息

文件膨胀控制

  • Daily notes 超 400 行时注意控制
  • 月归自动清理 30 天前的旧文件
  • 专题文件完成后及时标 archived

已知局限与待办

短板

  1. 自动化程度低 — 最大短板。飞飞不说"记一下",信息可能丢(四道防线在弥补)
  2. 无知识图谱 — 关系型知识只能文本描述,不能结构化查询
  3. 时序感知弱 — QMD 搜索不对时间加权,旧信息和新信息权重相同
  4. QMD 索引有延迟 — 刚写入的内容搜不到(增量索引非实时)
  5. 扩展性上限 — 文件数量会随时间膨胀,需要月归控制

待办(下次升级方向)

  • daily notes 分段文件写入规范
  • 启动清单优化(去掉 Project Context 已有的重复读取)
  • daily notes 膨胀控制(单日超 400 行的处理策略)
  • 遗忘/衰减机制(等 QMD 官方支持)
  • 时序感知搜索(等 QMD 支持时间加权)
  • 知识图谱(当前用关系表替代,等需求更复杂时再考虑)

核心态度:短板可以等 OpenClaw 官方来补。优势是架构层面的,别人抄不走。


版本历史

版本 日期 关键变更
v1.0 2026-02-05 ~ 07 初始体系:工作区文件结构 + daily notes + 启动清单
v1.1 2026-02-08 道术法三层认知架构确立
v1.2 2026-02-14 ~ 20 自动化 cron 体系(周记、月归、晚间复盘、战果)
v2.0 2026-02-23 五项改进:Pre-Compaction + 标签 + 热区 + 专题生命周期 + 关系表
v2.1 2026-02-23 /new 记忆漏洞修复(session-memory hook + 四道防线)
v2.2 2026-02-23 第六轮全链路审查通过(13 项测试),正式投入使用

详细变更记录:memory/记忆系统升级日志.md


相关文件索引

文件 作用 什么时候看
memory/记忆系统升级日志.md 版本迭代详细记录(v1.0→v2.2) 要了解每个版本改了什么
memory/道术法记忆系统-公开版.md 脱敏版,给别人看的 要分享给其他 OpenClaw 用户
memory/我们的记忆系统-2026-02-23.md 全景评估报告(对比 mem0、Hindsight) 要了解我们的系统和业界的对比
AGENTS.md 所有操作规则的权威来源 要查具体的操作规则
MEMORY.md 精华记忆(道、人物、热区) 每次启动自动加载
memory/道.md 道的完整版 + 讨论背景 要深入理解某条道的来源
memory/lessons-learned.md 术的合集 要避免重复踩坑
memory/procedures.md 法的合集 要查标准操作流程
pages/memory-system/index.html 公开版网页(已部署) https://memory-system.pages.dev

设计哲学

道是透镜,不是锤子。 用道去观察和思考,不套所有东西。能排除才有力量。

人类可审查比全自动更重要。 所有记忆都是 Markdown 纯文本。随时可以打开看、改、删。

少即是多。 效果最好且成本最低的交叉点才是最优解。如无必要,勿增实体。

知道刚好 > 知道太多。 每一层只给需要的人看需要的部分。


此文件由飞飞与 Maddox 在 19 天实战迭代后整理。2026 年 2 月 23 日。 这是我们的文化遗产。好好对待它。