OpenClaw Memory System v1.0#

基于 Ray Wang 的生产实践经验，30天迭代的记忆管理系统。

核心原则#

文件 = 事实来源

• Context Window 是工作台，文件才是仓库
• 不写进文件的东西 = 你从来不知道的东西

三层架构#

1. 短期层：NOW.md#

• 用途：Agent 的"工作台"，当前状态、优先级、阻塞项
• 特点：覆写式（每次 heartbeat 更新）
• 位置： ~/.openclaw/workspace/NOW.md

2. 中期层：memory/YYYY-MM-DD.md#

• 用途：事件流水，记录当天发生的一切
• 特点：追加式，永不覆写
• 位置： ~/.openclaw/workspace/memory/

3. 长期层：INDEX.md → 结构化知识库#

• 用途：提炼后的可复用知识
• 目录：lessons/、decisions/、people/、projects/、preferences/
• 位置： ~/.openclaw/workspace/memory/INDEX.md

目录结构#

text

workspace/
├── NOW.md                  # 短期：状态仪表盘（覆写式）
├── MEMORY.md               # 指向 INDEX.md 的指针
├── AGENTS.md               # Agent 操作手册
├── HEARTBEAT.md            # Heartbeat 执行流程
│
└── memory/
    ├── INDEX.md            # 知识导航（启动时必读）
    ├── YYYY-MM-DD.md       # 每日日志（追加式）
    │
    ├── decisions/          # 战略决策记录
    ├── lessons/            # 可复用教训
    ├── people/             # 人物画像
    ├── projects/           # 项目状态
    ├── preferences/        # 用户偏好
    ├── reflections/        # 每日自省
    ├── actions/            # 任务卡片
    │
    └── .archive/           # 冷存储（不索引）

Frontmatter 规范#

yaml

---
title: "主题"
date: 2026-03-24
category: lessons|person|decision
priority: 🔴|🟡|⚪
status: active|superseded|conflict
last_verified: 2026-03-24
tags: []
---

状态流转#

text

active ──→ superseded    (被更新版本取代)
active ──→ conflict      (发现矛盾信息，待人工裁决)
conflict ──→ active      (人工裁决后恢复)

生命周期#

日间（Heartbeat 每 30-60 分钟）#

1. 扫描活跃 session 消息
2. 提取重要信息写入日志
3. 路由到对应知识文件（轻量去重）
4. 刷新 NOW.md

23:30 日志同步#

• 扫描全天所有 session 补漏

23:45 夜间反思#

1. 读取上下文（今日日志 + NOW.md + 相关知识文件）
2. 写反思（计划 vs 实际 + 教训 + 明天改变）
3. 清理日志（去重）
4. CRUD 回写知识库 ← 核心
5. 过时扫描（>30 天标记 [⚠️ STALE]）

每周日 00:00 GC 归档#

• 日志 >30 天 + 无引用 → .archive/
• 反思 >30 天 → 归档
• 核心知识（decisions/、lessons 🔴、people/）永不归档

温度模型#

温度状态处理T > 0.7🔥 Hot保持活跃索引0.3 < T ≤ 0.7🌤️ Warm保留但检索降权T ≤ 0.3🧊 Cold移至 .archive/text

Temperature = w_age × age_score + w_ref × ref_score + w_pri × priority_score

写入工具#

工具用途场景memlog.sh "Title" "Body"日记追加事件、完成、决策Write NOW.md覆写仅 NOW.mdprintf >> file追加lessons/ people/ 等

写入禁忌#

• ❌ 硬编码时间戳（用脚本自动取）
• ❌ 用 Edit 修改 memory/ 文件
• ❌ 用 Write 覆写已有 memory/ 文件
• ❌ 写无实质内容的噪音
• ❌ 不读就写知识文件

检索策略#

L1: 扫 INDEX.md → 定位目标文件#

• 适用：知道要找什么类别

L2: 直接读取目标文件#

• 适用：已知具体文件路径

L3: QMD 语义搜索#

• 适用：不确定信息在哪个文件

CRUD 验证#

写入知识文件时必须：

1. READ - 读取目标文件当前内容

2. COMPARE - 比较新知识与已有内容

   • 已有覆盖新知识 → NOOP (跳过)
   • 新知识更新 → UPDATE (旧版标记 superseded)
   • 新知识矛盾 → CONFLICT (两版保留 + 标记)
   • 全新的知识 → ADD (追加)

3. METADATA - 更新 last_verified 日期

记忆幻觉防护#

类型描述例子编造写入从未发生过的事情Agent 声称"昨天做了 X"错误写入不准确的信息把 A 的观点归因给 B冲突同一事实的两个矛盾版本并存说"用方案 A"又说"用方案 B"遗漏重要信息没有被记录关键决策没写进文件

快速上手（最小配置）#

yaml

workspace/
├── NOW.md           # 状态板
├── AGENTS.md        # Agent 操作手册
└── memory/
    └── YYYY-MM-DD.md  # 每日日志

Obsidian 集成#

将 memory/ 目录设为 Obsidian vault：

• 启用核心插件：File explorer、Graph view、Backlinks、Daily notes
• 设置 useMarkdownLinks: false，启用 [[wiki-link]]
• 开启"显示隐藏文件"浏览归档

设计灵感#

• 人脑记忆整合（睡眠时整合）
• 艾宾浩斯遗忘曲线
• Stanford Generative Agents
• Mem0 / MemGPT / HaluMem