Agent Memory Framework

三层记忆系统框架。为 Agent 提供持久化记忆能力,包括日记忆、长期记忆和归档机制。触发词:记忆系统、memory system、记忆初始化、设置记忆、新建记忆、记忆蒸馏、归档记忆。当需要为新 Agent 配置记忆能力、或管理已有记忆时使用。

Audits

Pending

Install

openclaw skills install agent-memory-framework

Memory System — 三层记忆框架

架构概览

工作记忆(当前会话)     ← 临时,不持久
  ↓ 写入
日记忆 memory/YYYY-MM-DD.md  ← 原始日志,按天归档
  ↓ 蒸馏(定期提炼)
长期记忆 MEMORY.md            ← 策划精华,跨会话持久
  ↓ 活性归档(30天未引用)
归档 memory/archive/          ← 冷存储,可追溯

核心文件

文件用途何时写
MEMORY.md长期记忆(策划精华)重要决策、教训、认知更新时
memory/YYYY-MM-DD.md日记忆(原始日志)每次会话有值得记录的事时
memory/archive/归档(冷存储)30天未被引用的章节移入

初始化(新 Agent 首次设置)

  1. 在工作目录创建 MEMORY.md,使用模板 assets/MEMORY.md
  2. 创建 memory/ 目录
  3. AGENTS.md(或等效配置文件)中添加记忆规则(见 references/conventions.md
  4. 可选:配置蒸馏 cron(见 references/distillation.md

日常使用

写入规则

  • 日记忆:会话中有值得记录的事 → 写入 memory/YYYY-MM-DD.md
  • 长期记忆:重大决策/教训/认知 → 同时写入 MEMORY.md
  • "Mental notes" 不算 — 不写文件的记忆不会存活到下次会话
  • 先写再说 — 如果需要记住,先写文件,不要靠"我记住了"

读取规则

  • 主会话(与用户的私密对话):可自由读写 MEMORY.md
  • 共享会话(群聊、Discord、多人场景):禁止加载 MEMORY.md — 防止私人信息泄露
  • 日记忆:任何会话都可读,但只写当天的文件

安全红线

  • MEMORY.md 可能包含用户私人信息,绝不在共享上下文中加载
  • 归档文件同样可能含敏感信息,共享场景也禁读
  • 任何记忆文件不得外传(email、公开帖子等)

归档规则

  • 30天未被心跳/会话引用 → 移到 memory/archive/
  • 教训编号永远保留(编号不可回收,即使教训已过时)
  • 动态信息 >14天未更新 → 降级或归档(策略、持仓等)
  • 不按文件大小归档 — 信息密度不同,大小不是好指标
  • 归档时在 MEMORY.md 保留一行占位(章节名 + 归档日期),方便追溯

蒸馏(定期提炼)

将日记忆中值得长期保留的内容提炼到 MEMORY.md

详细流程见 references/distillation.md

零内容原则

本 Skill 只提供框架和规则,不包含任何记忆内容。每个 Agent 安装后从零积累自己的记忆。