memory-manager

核心用法

Memory Manager 为 AI Agent 提供企业级本地记忆架构，采用认知科学验证的三层记忆模型：情景记忆（Episodic，时间轴事件日志）、语义记忆（Semantic，知识事实库）、程序记忆（Procedural，可复用工作流）。用户通过 init.sh 初始化目录结构，，detect.sh 实时监控内存压缩风险（70%预警/85%临界），snapshot.sh 自动保存关键状态，，organize.sh 智能归类历史文件，配合 search.sh 实现分类型精准检索。

显著优点

架构科学性：直接应用 Zep 团队研究成果，知识图谱结构比扁平向量检索效率提升 18.5%，实现自然去重与上下文感知搜索。完全本地化：零网络依赖、零 API 成本、<100ms 检索延迟，数据 100% 用户自主可控，契合"记忆即身份"的隐私理念。工程实用性：Heartbeat 集成支持每 2 小时自动检测，备份机制保留原始文件至 legacy 目录，避免数据丢失风险。Bash 脚本实现零编译依赖，跨平台兼容性强。

潜在局限

检索能力边界：v1.0 版本仅支持基础关键词搜索，缺乏语义嵌入与知识图谱可视化，复杂关联查询能力有限。自动化程度：记忆分类依赖手动触发或规则匹配，ML 驱动的自动归类需等待 v1.1 版本（50+ 安装量解锁）。规模瓶颈：纯文件存储架构在超大规模记忆场景（百万级条目）下可能面临性能衰减，当前设计更适配个人/中小 Agent 场景。生态锁定：深度绑定 OpenClaw 工作区规范，迁移至其他 Agent 框架需适配成本。

目标群体

长期运行 Agent 开发者：需维持跨会话上下文连贯性的自动化工作流场景。隐私敏感型用户：拒绝云端记忆服务、要求数据完全本地化的企业/个人。认知架构研究者：希望实验三重记忆模型在 LLM 应用中的实际效果。Moltbook/ClawdHub 生态用户：原生集成该 Agent 经济社区的技能发布与迭代流程。

使用风险

性能风险：高频写入（如每分钟快照）可能触发磁盘 I/O 瓶颈，建议配合 detect.sh 阈值智能触发。依赖风险：可选依赖 jq 缺失时部分 JSON 状态功能降级，但核心功能不受影响。误分类风险：organize.sh 的启发式规则可能将混合内容错误归类，关键记忆建议手动 categorize.sh 复核。存储膨胀：legacy 备份与 snapshots 累积可能占用双倍空间，需定期人工清理。

核心用法

memory-manager 采用认知科学验证的三层记忆架构（语义/程序/事件），为 AI Agent 提供本地化长期记忆管理。

初始化与日常操作：运行 init.sh 建立目录结构后，detect.sh 监控记忆负载（70%/85% 阈值预警），snapshot.sh 在压缩前自动备份，organize.sh 将零散记忆智能归类到三层结构中。检索支持分类型搜索（search.sh episodic/semantic/procedural/all）和通配查询。

记忆组织逻辑：事件记忆（episodic）按时间轴记录「做了什么」，语义记忆（semantic）沉淀「知道什么」的知识网络，程序记忆（procedural）固化「怎么做」的可复用流程。该架构源于 Zep 团队研究，知识图谱比扁平向量检索效率高 18.5%。

显著优点

1. 极致隐私与成本：100% 本地文件系统，零 API 费用、零网络依赖、零第三方库，数据完全自主可控。
2. 检索精准度：三层分类天然实现上下文感知，避免向量检索的语义漂移问题。
3. 人类可读：Markdown 格式便于审计、调试和人工干预。
4. 压缩防护机制：主动监控 + 自动快照，避免 Agent 因上下文溢出丢失关键记忆。

潜在局限

• 搜索能力有限：v1.0 仅支持关键词匹配，无向量语义相似度搜索
• 自动分类待完善：当前依赖手动或启发式归类，ML 自动分类在 v1.1 路线图
• T3 来源可信度：个人开发者维护，长期更新稳定性需观察
• 无跨设备同步：纯本地架构的代价，云备份需 v2.0 才支持

适合人群

• 需要长期会话保持的复杂任务 Agent
• 对数据隐私敏感的金融、医疗、法律场景
• 希望降低 API 成本的规模化部署
• 重视记忆可审计性的企业合规场景

常规风险

1. 路径遍历（低风险）：categorize.sh 等脚本构造文件路径，虽限定在 memory/ 目录，但建议输入过滤 ../ 序列。
2. T3 来源风险：个人开发者账号，建议通过 GitHub Org 或基金会托管提升至 T2。
3. 存储膨胀：无自动清理策略，高频使用 Agent 需定期手动归档旧记忆。

---

> 安全认证：CLS-Certify A级（85分），零网络请求、零危险函数、零第三方依赖。