Memory Layer - 三层记忆系统
🧠 基于 Claude Code 记忆哲学,为 OpenClaw 设计
核心原则
| 原则 | 说明 |
|---|---|
| 分层加载 | Index 永远加载,Topic 按需,Transcript 仅 grep |
| 写纪律 | 先写 Topic,再更新 Index(防止膨胀) |
| 敏感数据不存储 | Transcript 是纯文本,禁止存储账号/密码/健康记录 |
| 自动化 | autoDream 夜间整理(默认禁用,需手动启用) |
架构
┌─────────────────────────────────────────┐
│ MEMORY.md (Index 层) │
│ - 仅指针,≤25KB │
│ - 始终加载到上下文 │
└───────────────┬─────────────────────────┘
│ 按需加载 (2-5 个文件)
▼
┌─────────────────────────────────────────┐
│ memory/topics/*.md (Topic 层) │
│ - 结构化知识,≤50KB/文件 │
│ - 仅在相关时加载 │
└───────────────┬─────────────────────────┘
│ 永不加载,仅 grep
▼
┌─────────────────────────────────────────┐
│ memory/transcripts/*.log (Transcript 层)│
│ - 原始日志,仅追加 │
│ - >90 天自动归档 │
└─────────────────────────────────────────┘
如何使用
1. 创建目录结构
mkdir -p memory/topics memory/transcripts/$(date +%Y-%m)
2. 迁移现有记忆文件
# 备份(重要)
cp -r memory/ memory.backup.$(date +%Y%m%d)
# 迁移(根据你的目录结构调整)
cp memory/investments/*.md memory/topics/ # 示例
cp memory/projects/*.md memory/topics/ # 示例
cp memory/assets/*.md memory/topics/ # 示例
3. 重构 MEMORY.md
手动重写为 Index 格式(参考 references/index-spec.md):
# MEMORY.md - OpenClaw 记忆索引
## Topics
| 领域 | 主题 | 路径 | 更新 | 摘要 | 标签 | 重要性 |
|------|------|------|------|------|------|--------|
| 项目 | 内容工具 | memory/topics/project-tool.md | 2026-04-02 | 创作工具 | AI | 0.7 |
4. 启用 autoDream(可选)
# 默认配置已禁用,需手动启用
openclaw cron add "0 23 * * *" "memory-system auto-dream"
依赖
| 依赖 | 必需 | 说明 |
|---|---|---|
| OpenClaw CLI | ✅ | 唯一依赖 |
| OpenClaw Cron | ❌ | 仅 autoDream 需要 |
无需额外工具:本 Skill 是纯文档设计,memory-system 等工具不存在。
配置
默认配置:config/default.json(Skill 自带)
自定义配置:~/.openclaw/memory-config.json(可选)
{
"autoDream": {
"enabled": false,
"schedule": "23:00",
"notifyOnComplete": false
}
}
文档导航
| 文档 | 说明 |
|---|---|
| references/architecture.md | 完整架构设计 |
| references/index-spec.md | Index 层格式规范 |
| references/topic-spec.md | Topic 层格式规范 |
| references/transcript-spec.md | Transcript 层格式规范 |
| references/autodream.md | autoDream 算法详情 |
| references/config.md | 完整配置参数 |
| guides/MIGRATION.md | 迁移指南 |
| guides/EXAMPLES.md | 使用示例 |
版本:2.0 | 最后更新:2026-04-03 | 代号:Memory Layer