🧠 道术法记忆系统 — 内部 README
这是什么: 飞飞与 Maddox 共同迭代构建的 AI 长期记忆系统说明书。 本文是架构说明与阶段快照,不是实时运行面板。
⚠️ 判定优先级: 如与实时执行有差异,以
AGENTS.md+openclaw cron list+HEARTBEAT.md为准。谁该读这个文件: 新启动的 Maddox、飞飞本人、任何想理解这个系统的人。
目录
一句话概括
把记忆当文件系统管理 — 有写入、有提炼、有归档、有搜索、有自动化维护。不用数据库,不花钱,全透明可审查。
文件地图
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就能看 - 可审查:飞飞随时打开任何文件查看、修改、删除
- 零成本:不需要付费服务、数据库、额外基础设施
操作手册
"记一下" 触发时
- 写到
memory/YYYY-MM-DD.md(不直接写 MEMORY.md) - 加标签前缀
- 范围: 默认只记当前话题。飞飞说"把今天的都记一下"才全面回顾
- 先存原始版本,不纠结分类
Pre-Compaction Flush 触发时
- 不只存"当前在聊什么"
- 回扫整段对话主动提取:偏好变化、决策及理由、新人物/项目、金句洞察、未完成待办
- 追加到当天的 daily notes
- 宁可多记一条,不要漏掉关键信息
新的道确立时
- 写入 MEMORY.md 道部分(精华版)
- 同时写入 memory/道.md(完整版 + 讨论背景)
- 双写,不能只写一个地方
子智能体指令编写
- 子智能体不读 MEMORY.md、不翻 memory/ 文件
- 它需要的一切都在 Maddox 写的指令里
- 按需摘取术和法注入指令,不给全量
- 用户偏好(语言、格式等)需在指令中明确写出
维护指南
每天(自动)
- 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
已知局限与待办
短板
- 自动化程度低 — 最大短板。飞飞不说"记一下",信息可能丢(四道防线在弥补)
- 无知识图谱 — 关系型知识只能文本描述,不能结构化查询
- 时序感知弱 — QMD 搜索不对时间加权,旧信息和新信息权重相同
- QMD 索引有延迟 — 刚写入的内容搜不到(增量索引非实时)
- 扩展性上限 — 文件数量会随时间膨胀,需要月归控制
待办(下次升级方向)
- 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 日。 这是我们的文化遗产。好好对待它。