Hippocampus

核心功能

Hippocampus 是一套为 AI 代理设计的背景记忆器官，灵感源自人脑海马体，基于斯坦福大学 Park 等人 2023 年的生成式代理研究（Generative Agents）。它独立于主代理运行，通过自动化脚本实现记忆的全生命周期管理：捕获 → 评分 → 存储 → 衰减/强化 → 检索。

显著优点

1. 科学背书：直接实现斯坦福论文中的记忆衰减公式（0.99^days）和强化机制，具有学术研究支撑
2. 结构化存储：将记忆按 domain 分类（user/self/relationship/world），配合 0.0-1.0 重要性评分和关键词标签
3. 自动化运维：通过 cron 任务实现每日衰减、每周整合，无需人工干预
4. OpenClaw 深度集成：生成 HIPPOCAMPUS_CORE.md 供 RAG 检索，与现有代理框架无缝对接
5. 生态扩展性：作为"AI Brain"系列的首个组件，预留与 amygdala（情感）、basal-ganglia（习惯）等模块的联动接口

潜在局限

• 文件系统依赖：基于本地 JSON 文件和 shell 脚本，无内置分布式或云端同步方案
• 评分主观性：初始重要性评分依赖规则匹配（如"I prefer"=0.8），缺乏 LLM 动态评估
• 无冲突解决：未明确处理记忆矛盾时的合并或覆盖策略
• 社区维护：作者标注为"Community"，长期更新稳定性待观察

适合人群

• 使用 OpenClaw 框架构建长期运行 AI 代理的开发者
• 需要代理跨会话保持用户认知和个性化记忆的场景
• 对认知架构和神经科学启发式 AI 设计感兴趣的研究者

常规风险

• 数据持久性：~/.openclaw/workspace 目录的备份策略需用户自行规划
• 隐私敏感：user/relationship 域可能存储个人敏感信息，需关注文件权限设置
• 衰减参数固化：0.99 的衰减系数和 15% 强化增量为硬编码，未开放配置文件调节
• 无加密机制：记忆文件以明文 JSON 存储，多用户系统存在泄露风险

核心功能与用法

Hippocampus 将人脑海马体的记忆机制引入 AI 代理系统，实现自动化的记忆生命周期管理：

记忆捕获流程：通过 preprocess.sh 自动分析会话记录，提取触发短语（"remember this"、"I prefer..."、情感内容等），按重要性 0.0-1.0 评分后分类存储至 user/（用户事实）、self/（自我认知）、relationship/（关系上下文）、world/（外部知识）四大域。

动态维护机制：

• 衰减：每日 cron 运行 decay.sh，采用斯坦福论文的指数衰减公式 importance × 0.99^days，90 天后保留约 40%
• 强化：每次调用 recall.sh --reinforce 时，按 old + (1-old)×0.15 提升重要性，模拟记忆的巩固效应

检索策略：支持分层检索——核心记忆（0.7+）自动加载、活跃记忆（0.4-0.7）常规搜索、背景记忆（0.2-0.4）特定查询触发。

显著优点

1. 学术根基扎实：直接实现 Park et al. (2023) 斯坦福生成式智能体论文的记忆架构，经小规模人类实验验证有效
2. 零外部依赖：纯 Python 标准库 + Shell 脚本，无第三方包供应链风险
3. 与 OpenClaw 深度集成：通过 HIPPOCAMPUS_CORE.md 桥接索引系统与 RAG 检索，记忆可直接注入代理上下文
4. 细粒度可控性：重要性评分透明、衰减公式可预测、支持手动调整阈值
5. 模块化扩展：作为 "AI Brain" 系列核心组件，可与 amygdala（情感）、basal-ganglia（习惯）等模块协同

局限性与风险

| 维度 | 说明 |

|------|------|

| **隐私合规** | 自动捕获用户对话内容，需明确知情同意；当前缺乏选择性退出机制（建议优先级：高） |

| **记忆质量** | 依赖启发式评分（关键词匹配、情感检测），可能误判重要性或产生噪声记忆 |

| **规模瓶颈** | JSON 文件索引在大规模记忆场景下检索效率可能下降，未采用向量数据库 |

| **跨会话一致性** | 依赖文件系统状态，多设备同步需额外配置 |

| **误强化风险** | 频繁检索低质量记忆可能导致其重要性虚高 |

适合人群

• 需要长期个性化交互的 AI 代理开发者（虚拟陪伴、个人助理场景）
• 研究认知架构和代理记忆的学术界/爱好者
• 已使用 OpenClaw 框架、希望增强代理连贯性的用户

常规风险提醒

• 数据残留：即使衰减至 <0.2，记忆仍物理存储直至手动清理，敏感内容可能长期留存
• 权限配置：工作区目录建议设为 700 权限，防止其他用户读取记忆内容
• 版本兼容性：v3.x 索引格式与早期版本可能不兼容，升级前建议备份