Memory Layer - 三层记忆系统#

🧠 基于 Claude Code 记忆哲学，为 OpenClaw 设计

---

核心原则#

原则说明分层加载Index 永远加载，Topic 按需，Transcript 仅 grep写纪律先写 Topic，再更新 Index（防止膨胀）敏感数据不存储Transcript 是纯文本，禁止存储账号/密码/健康记录自动化autoDream 夜间整理（默认禁用，需手动启用）

---

架构#

text

┌─────────────────────────────────────────┐
│   MEMORY.md (Index 层)                   │
│   - 仅指针，≤25KB                        │
│   - 始终加载到上下文                      │
└───────────────┬─────────────────────────┘
                │ 按需加载 (2-5 个文件)
                ▼
┌─────────────────────────────────────────┐
│   memory/topics/*.md (Topic 层)          │
│   - 结构化知识，≤50KB/文件               │
│   - 仅在相关时加载                        │
└───────────────┬─────────────────────────┘
                │ 永不加载，仅 grep
                ▼
┌─────────────────────────────────────────┐
│   memory/transcripts/*.log (Transcript 层)│
│   - 原始日志，仅追加                      │
│   - >90 天自动归档                        │
└─────────────────────────────────────────┘

---

如何使用#

1. 创建目录结构#

bash

mkdir -p memory/topics memory/transcripts/$(date +%Y-%m)

2. 迁移现有记忆文件#

bash

# 备份（重要）
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）：

markdown

# MEMORY.md - OpenClaw 记忆索引

## Topics
| 领域 | 主题 | 路径 | 更新 | 摘要 | 标签 | 重要性 |
|------|------|------|------|------|------|--------|
| 项目 | 内容工具 | memory/topics/project-tool.md | 2026-04-02 | 创作工具 | AI | 0.7 |

4. 启用 autoDream（可选）#

bash

# 默认配置已禁用，需手动启用
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（可选）

json

{
  "autoDream": {
    "enabled": false,
    "schedule": "23:00",
    "notifyOnComplete": false
  }
}

---

文档导航#

文档说明references/architecture.md完整架构设计references/index-spec.mdIndex 层格式规范references/topic-spec.mdTopic 层格式规范references/transcript-spec.mdTranscript 层格式规范references/autodream.mdautoDream 算法详情references/config.md完整配置参数guides/MIGRATION.md迁移指南guides/EXAMPLES.md使用示例

---

版本：2.0 | 最后更新：2026-04-03 | 代号：Memory Layer