mcpField
M
memory-management

memory-management

github.com/jzocbAgent 工作流39228 次安装38 周前更新
代码仓库

关于 memory-management

用于按三层架构管理 Agent 记忆的技能,涵盖常驻核心笔记、可搜索经验和原始日记。它通过优先级与保留期限组织内容,并提供归档流程以控制常驻记忆规模。

主要功能

  1. 01三层记忆组织方式
  2. 02优先级标签与保留期限
  3. 03可搜索的结构化经验文件
  4. 04使用清理脚本自动归档
  5. 05检查记忆规模并试运行

适用场景

  1. 01精简 Agent 核心笔记
  2. 02归档过期的项目内容
  3. 03搜索已保存的排障经验
  4. 04清理前检查记忆内容

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jzocb/openclaw-memory-management --skill memory-management

安装后在 Claude Code 中输入/memory-management确认已加载。

详细介绍

记忆管理技能

使用三层架构和自动归档,高效管理 Agent 记忆。

快速设置

  1. 为 MEMORY.md 添加优先级标签:
- [P0] Core identity item (never expires)
- [P1][2026-02-10] Active project (90-day TTL)
- [P2][2026-02-10] Temporary item (30-day TTL)
  1. 设置自动归档 cron:
0 4 * * * python3 ~/.openclaw/workspace/scripts/memory-janitor.py
  1. 将经验教训存储在 memory/lessons/*.jsonl 中:
{"id": "lesson-001", "date": "2026-02-10", "category": "infra", "title": "Problem title", "problem": "What happened", "solution": "How to fix", "tags": ["tag1"]}

三层架构

第 1 层:热记忆(MEMORY.md)

  • 始终加载,不超过 200 行
  • P0:核心身份,永不过期
  • P1:活跃项目,TTL 为 90 天
  • P2:临时内容,TTL 为 30 天

第 2 层:冷记忆(可搜索)

  • memory/lessons/*.jsonl — 结构化经验教训
  • memory/archive/ — 已过期内容
  • 使用 memory_search 回忆

第 3 层:原始日志

  • memory/YYYY-MM-DD.md — 每日日志
  • 不会自动加载

优先级指南

优先级用途TTL
P0用户身份、偏好、安全规则永不过期
P1活跃项目、当前策略90 天
P2调试笔记、一次性事件30 天

核心原则(AGENTS.md 中最多 5 条)

仅在 AGENTS.md 中保留必要规则。其他经验教训放入 lessons/*.jsonl。

5 条规则示例:

  1. 涉及真钱时,正确性优先于速度
  2. 外部操作需要确认
  3. 检查两个 cron 系统(system + OpenClaw)
  4. 长时间运行的进程需要通过 setsid 隔离
  5. 交易前阅读平台规则

记忆内容过多时

运行 janitor 并查看统计信息:

python3 scripts/memory-janitor.py --stats

如果超过 200 行:

  1. 检查 P0 条目——它们是否真的都永久有效?
  2. 为缺少日期的 P1/P2 条目补上日期
  3. 将详细内容移至 lessons/*.jsonl
  4. 先运行 --dry-run,然后再归档

评论

支持 Markdown