Agent Memory System 🧠

OpenClaw Agent 长期记忆系统

让 AI Agent 拥有持久记忆，自动管理冷热数据，从经验中提炼可复用技能。

核心功能

1. 温度模型

2. 自动 GC（每周日 00:00）

# 自动执行
./scripts/memory-gc.sh

功能：

• 扫描超过 30 天的日志文件
• 移动到 .archive/YYYY-MM/ 目录
• 生成 GC 报告
• 统计温度分布

3. 夜间反思（每日 23:45）

# 自动执行
./scripts/nightly-reflection.sh

功能：

• 验证记忆 CRUD
• 创建反思记录
• 更新健康度统计
• 检查待归档数据

4. 技能提炼

# 从教训中提取技能
./scripts/extract-skill.sh <lesson-name> [skill-name]

功能：

• 从 memory/lessons/ 读取教训
• 生成 skills/<skill-name>/ 技能包
• 自动创建 SKILL.md 模板

目录结构

workspace/
├── MEMORY.md                    # 核心长期记忆（<5KB）
└── memory/
    ├── INDEX.md                 # 导航索引
    ├── YYYY-MM-DD.md            # 每日日志
    ├── lessons/                 # 经验教训
    │   ├── README.md            # 教训索引
    │   └── <topic>.md           # 具体教训
    ├── decisions/               # 重大决策
    │   ├── README.md            # 决策索引
    │   └── YYYY-MM-DD-*.md      # 决策记录
    ├── people/                  # 人物档案
    ├── reflections/             # 反思记录
    └── .archive/                # 归档数据
        └── YYYY-MM/             # 按月归档

快速开始

1. 安装

# 方法一：从 clawhub 安装
clawhub install agent-memory-system

# 方法二：手动安装
cp -r agent-memory-system ~/.openclaw/workspace/skills/

2. 初始化目录

mkdir -p ~/.openclaw/workspace/memory/{lessons,decisions,people,reflections,.archive}
touch ~/.openclaw/workspace/memory/INDEX.md
touch ~/.openclaw/workspace/MEMORY.md

3. 配置 Cron 任务

# 编辑 crontab
crontab -e

# 添加以下内容
0 0 * * 0 ~/.openclaw/workspace/skills/agent-memory-system/scripts/memory-gc.sh >> ~/.openclaw/logs/memory-gc.log 2>&1
45 23 * * * ~/.openclaw/workspace/skills/agent-memory-system/scripts/nightly-reflection.sh >> ~/.openclaw/logs/nightly-reflection.log 2>&1

4. 验证安装

# 手动运行一次 GC
~/.openclaw/workspace/skills/agent-memory-system/scripts/memory-gc.sh

# 手动运行一次反思
~/.openclaw/workspace/skills/agent-memory-system/scripts/nightly-reflection.sh

使用指南

Agent 每日工作流

1. 会话开始

   • 读取 MEMORY.md 获取核心记忆
   • 检查今日日志 memory/YYYY-MM-DD.md

2. 会话中

   • 重要决策 → 记录到 decisions/
   • 犯错/教训 → 记录到 lessons/
   • 人物信息 → 记录到 people/

3. 会话结束

   • 更新每日日志
   • 标记完成事项

从教训提取技能

# 假设有一个教训文件: memory/lessons/deploy-without-test.md
./scripts/extract-skill.sh deploy-without-test

# 会生成: skills/deploy-without-test/SKILL.md
# 然后手动完善 SKILL.md 内容

查询归档数据

# 查看归档目录
ls -la memory/.archive/

# 搜索归档内容
grep -r "关键词" memory/.archive/

记忆模板

MEMORY.md 模板

# MEMORY.md - 长期记忆

> 核心知识和决策的精华

## 核心决策

| 决策 | 状态 | 优先级 | 最后更新 |
|------|------|--------|----------|
| ... | ... | ... | ... |

## 最佳实践

...

## 经验教训索引

| ID | 主题 | 类别 | 状态 |
|----|------|------|------|
| ... | ... | ... | ... |

每日日志模板