Memory Archiver Skill - 记忆归档技能

版本: 10.3.0 (安全修复：execFile 杜绝命令注入)
创建日期: 2026-03-11
更新日期: 2026-04-14
作者: c32

📋 技能描述

二维记忆架构：时间分层 × 类型标签

• - 时间分层: daily (每天) → weekly (每周) → long-term (长期/MEMORY.md)
• 类型标签: [episodic] 事件 / [semantic] 知识 / [procedural] 流程
• 存储: 每日记忆 + 每周记忆 + 长期精选记忆
• WAL 协议: Write-Ahead Log，写前日志防数据丢失
• 统一 Hook (message:received): 自动搜索 + 自动提取 + 会话笔记追踪（整合原 auto-memory-extract + session-notes）

🎯 功能清单

时间分层任务

记忆巩固（原 auto-dream）

自动搜索 Hook（多维度增强）

自动记忆提取

会话笔记追踪

📂 文件结构

skills/memory-archiver/
├── SKILL.md # 本文件
├── skill.json # 技能元数据
├── _meta.json # ClawHub 元数据
├── .clawhub/ # ClawHub 同步目录
│ └── origin.json # 来源信息
├── scripts/
│ ├── install.js # 安装脚本（含 hook 自动注册）
│ ├── auto-memory-search.js # 自动记忆搜索（被 hook 调用）
│ ├── memory-loader.js # 加载记忆到缓存
│ ├── memory-search.js # 搜索记忆
│ ├── memory-refresh.js # 智能刷新缓存
│ ├── memory-dedup.js # MEMORY.md 段落级去重
│ ├── memory-extract.js # 从对话提取记忆
│ ├── memory-classify.js # 关键词分类器
│ ├── memory-dedup-extract.js # 提取去重（MD5 hash）
│ ├── memory-aging.js # 记忆老化与数量限制检查
│ ├── dream-consolidate.js # 记忆巩固主程序（闸门+索引+编排，原 auto-dream）
│ ├── dream-lock.js # 文件锁（防止并发巩固）
│ ├── session-tracker.js # 会话笔记追踪
│ └── README.md # 脚本说明文档
├── hooks/ # Hook 源文件（安装时复制到 workspace/hooks/）
│ ├── handler.js # Hook 处理器（事件：message:received）
│ ├── HOOK.md # Hook 元数据
│ └── bootstrap-loader/ # 启动加载 Hook
│ ├── handler.js # Hook 处理器（事件：agent:bootstrap）
│ └── HOOK.md # Hook 元数据
└── prompts/ # 提示词
└── consolidation.md # 记忆巩固提示词

安装后的工作区文件

~/.openclaw/workspace/
├── MEMORY.md # 长期精选记忆
├── hooks/
│ └── memory-archiver-hook/ # Hook（由 install.js 自动部署）
│ ├── handler.js
│ └── HOOK.md
└── memory/
├── daily/ # 每日记忆
├── weekly/ # 每周记忆
├── auto/ # 自动分类记忆 (user/feedback/project/reference)
├── .dream-state.json # 巩固状态（自动维护）
└── .dream.lock # 巩固文件锁

🔧 安装

方法 1: 通过 ClawHub 安装（推荐 ⭐）

bash
clawhub install memory-archiver

安装后自动执行：

1. 1. 创建 memory/daily/ 和 memory/weekly/ 目录
2. 部署 hook 到 workspace/hooks/memory-archiver-hook/
3. 执行 openclaw hooks install --link 注册 hook
4. 自动添加 3 个 cron 任务
5. 提示重启 gateway

方法 2: 本地技能目录（开发调试）

如果技能已在 ~/.openclaw/workspace/skills/memory-archiver/：

node ~/.openclaw/workspace/skills/memory-archiver/scripts/install.js

验证安装

openclaw hooks list

应看到 memory-archiver-hook (✓ ready)

openclaw cron list

应看到 3 个记忆相关任务

📝 记忆写入规范

三类记忆标签

记录原则

✅ 应该记录:

• - 关键决策和教训
• 新发现的有价值内容
• 技术栈使用经验
• 工作习惯调整
• 用户偏好

❌ 不应该记录:

• - ❌ 重复的上下文 — 已有记录的内容不再重复
• ❌ 毫无意义的日常 — 无事发生就不记
• ❌ 重复的任务进度提示 — 避免刷屏
• ❌ 私密细节 — 保护隐私
• ❌ 短期易变想法 — 临时念头不持久

核心判断: 这条信息在未来回顾时是否有价值？

🔍 记忆搜索

自动加载（OpenClaw 启动时）

每次 OpenClaw 启动时，通过 agent:bootstrap Hook 自动加载记忆到缓存，无需手动触发。

加载内容：今日 + 昨日 + 最近 3 天 daily + MEMORY.md + 最近 weekly

交互式搜索

node ~/.openclaw/workspace/skills/memory-archiver/scripts/memory-search.js 搜索内容

在对话中使用：
-