memory-archiver

# 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. 创建 `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*