Memory Archiver Skill - 记忆归档技能

版本: 7.0 (Hook 安装自动化)
创建日期: 2026-03-11
更新日期: 2026-03-23
作者: 前端 ⚡

📋 技能描述

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

• 时间分层: daily (每天) → weekly (每周) → long-term (长期/MEMORY.md)
• 类型标签: [episodic] 事件 / [semantic] 知识 / [procedural] 流程
• 存储: 每日记忆 + 每周记忆 + 长期精选记忆
• WAL 协议: Write-Ahead Log，写前日志防数据丢失
• 自动搜索 Hook: 检测用户消息类型，自动搜索记忆并注入上下文

🎯 功能清单

时间分层任务

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

📂 文件结构

skills/memory-archiver/
├── SKILL.md                          # 本文件
├── skill.json                        # 技能元数据
├── _meta.json                        # ClawHub 元数据
├── scripts/
│   ├── install.sh                    # 安装脚本（含 hook 自动注册）
│   ├── auto-memory-search.sh         # 自动记忆搜索（被 hook 调用）
│   ├── memory-loader.sh              # 加载记忆到缓存
│   ├── memory-search.sh              # 搜索记忆
│   ├── memory-refresh.sh             # 智能刷新缓存
│   ├── memory-dedup.sh               # 自动去重
│   └── README.md                     # 脚本说明文档
├── hooks/                            # Hook 源文件（安装时复制到 workspace/hooks/）
│   ├── handler.js                    # Hook 处理器（事件：message:received）
│   └── HOOK.md                       # Hook 元数据
└── .clawhub/                         # ClawHub 同步目录

安装后的工作区文件

~/.openclaw/workspace/
├── MEMORY.md                         # 长期精选记忆
├── hooks/
│   └── auto-memory-search/           # Hook（由 install.sh 自动部署）
│       ├── handler.js
│       └── HOOK.md
└── memory/
    ├── daily/                        # 每日记忆
    └── weekly/                       # 每周记忆

🔧 安装

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

clawhub install memory-archiver

安装后自动执行：

1. 创建

   memory/daily/

   和

   memory/weekly/

   目录
2. 部署 hook 到

   workspace/hooks/auto-memory-search/

3. 执行

   openclaw hooks install --link

   注册 hook
4. 自动添加 3 个 cron 任务
5. 提示重启 gateway

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

如果技能已在

~/.openclaw/workspace/skills/memory-archiver/

bash ~/.openclaw/workspace/skills/memory-archiver/scripts/install.sh

验证安装

# 检查 hook 是否注册
openclaw hooks list
# 应看到 🔍 auto-memory-search (✓ ready)

# 检查 cron 任务
openclaw cron list
# 应看到 3 个记忆相关任务

📝 记忆写入规范

三类记忆标签

[episodic]

[semantic]

[procedural]

记录原则

✅ 应该记录:

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

❌ 不应该记录:

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

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

🔍 记忆搜索

方法 1: 使用记忆加载脚本（推荐 ⭐）

步骤 1: 加载记忆到内存

bash ~/.openclaw/workspace/skills/memory-archiver/scripts/memory-loader.sh

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

步骤 2: 搜索记忆

bash ~/.openclaw/workspace/skills/memory-archiver/scripts/memory-search.sh "关键词"

在对话中使用：

• 说

  加载记忆

  → 运行 memory-loader.sh
• 说

  搜索记忆：关键词

  → 运行 memory-search.sh

方法 2: 使用 grep 手动搜索

# 搜索所有记忆文件
grep -ri "CSS" ~/.openclaw/workspace/memory/

# 带上下文显示
grep -riC 3 "CSS" ~/.openclaw/workspace/memory/daily/*.md

📊 版本历史

skill.json

postinstall

clawhub install

🛠️ 维护命令

# 检查记忆文件总量
du -sh ~/.openclaw/workspace/memory/

# 查看每日记忆文件
ls -lh ~/.openclaw/workspace/memory/daily/

# 搜索记忆内容
grep -ri "关键词" ~/.openclaw/workspace/memory/

文档最后更新：2026-03-20