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

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: 检测用户消息类型，自动搜索记忆并注入上下文

---

🎯 功能清单

时间分层任务

任务	频率	说明
记忆及时写入	10 分钟	检查并写入重要信息到 daily 文件
记忆归档 - Daily 层

每天 23:00 | 提炼当天内容到 daily 文件 | | 记忆总结 - Weekly 层 | 每周日 22:00 | 提炼 weekly 到 MEMORY.md 长期记忆 |

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

功能	说明
消息类型检测	疑问/修复/规范/特征/配置/命令/技术
关键词提取

自动提取中英文关键词 | | 维度 1: 关键词搜索 | 在 SESSION-STATE.md 缓存中搜索 | | 维度 2: 类型标签搜索 | 按 [episodic]/[semantic]/[procedural] 标签搜索 | | 维度 3: 时间维度搜索 | 今日→昨日→长期记忆，优先最近 | | 维度 4: 组合搜索 | 多关键词 OR 关系，扩大匹配范围 | | 上下文注入 | 合并所有维度结果注入 prompt |

---

📂 文件结构

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 安装（推荐 ⭐）

bash
clawhub install memory-archiver

安装后自动执行：

1. 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
bash ~/.openclaw/workspace/skills/memory-archiver/scripts/install.sh

验证安装

bash

检查 hook 是否注册

openclaw hooks list

应看到 🔍 auto-memory-search (✓ ready)

检查 cron 任务

openclaw cron list

应看到 3 个记忆相关任务

---

📝 记忆写入规范

三类记忆标签

标签	说明	例子
[episodic]	事件/经历	用户今天完成了模板重设计
[semantic]

知识/事实 | 用户喜欢 Tailwind CSS | | [procedural] | 流程/方法 | 部署步骤：1. 构建 2. 上传 3. 重启 |

记录原则

✅ 应该记录:

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

❌ 不应该记录:

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

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

---

🔍 记忆搜索

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

步骤 1: 加载记忆到内存
bash
bash ~/.openclaw/workspace/skills/memory-archiver/scripts/memory-loader.sh

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

步骤 2: 搜索记忆
bash
bash ~/.openclaw/workspace/skills/memory-archiver/scripts/memory-search.sh 关键词

在对话中使用：

• - 说 加载记忆 → 运行 memory-loader.sh
• 说 搜索记忆：关键词 → 运行 memory-search.sh

方法 2: 使用 grep 手动搜索

bash

搜索所有记忆文件

grep -ri CSS ~/.openclaw/workspace/memory/

带上下文显示

grep -riC 3 CSS ~/.openclaw/workspace/memory/daily/*.md

---

📊 版本历史

版本	日期	变更
7.0	2026-03-23	Hook 安装自动化: skill.json 添加 postinstall 脚本，clawhub install 自动部署 hook + cron
6.0

2026-03-20 | 整合 Auto Memory Search Hook: 将独立 Hook 合并到技能内 | | 5.0 | 2026-03-20 | 三层精简架构: 移除 monthly/yearly 层，保留 daily/weekly/long-term | | 4.0 | 2026-03-20 | 精简版: 移除向量搜索依赖，简化架构 | | 3.0 | 2026-03-19 | 向量增强版：整合 Qdrant + Transformers.js | | 2.0 | 2026-03-19 | 五层时间架构 (hourly/daily/weekly/monthly/yearly) | | 1.0 | 2026-03-11 | 初始版本 |

---

🛠️ 维护命令

bash

检查记忆文件总量

du -sh ~/.openclaw/workspace/memory/

查看每日记忆文件

ls -lh ~/.openclaw/workspace/memory/daily/

搜索记忆内容

grep -ri 关键词 ~/.openclaw/workspace/memory/

---

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