hippocampus-memory

🧠 斯坦福研究的AI持久记忆引擎

基于斯坦福Generative Agents研究的AI记忆系统,实现自动编码、重要性评分与语义强化,让Agent具备持久身份连续性。

收藏
902
安装
332
版本
v3.8.6
CLS 安全性认证2026-05-02
点击查看完整报告 >

使用说明

核心用法

Hippocampus Memory 是一套为 OpenClaw AI Agent 设计的持久化记忆系统,模拟人类大脑海马体的认知功能。其核心工作流程包括:通过 preprocess.sh 从对话记录提取信号,经 encode-pipeline.sh 进行重要性评分(0.0-1.0)和语义检查,利用 LLM 生成结构化记忆摘要,最终存储于本地 JSON 索引。系统支持自动衰减(每日 0.99^days 衰减率)和语义强化(重复话题自动提升重要性而非重复创建),并通过 recall.sh 实现带权重搜索,,load-core.sh 在会话启动时加载高重要性记忆。

显著优点

1. 学术背书:直接基于斯坦福大学 Park 等人 2023 年发表的 Generative Agents 研究,算法可信度极高。
2. 自动化程度高:安装后通过 cron 定时任务(每3小时编码、每日3点衰减)实现零维护运行,无需手动干预。

3. 智能去重机制:语义强化算法能识别相似话题,自动合并而非重复创建记忆,避免索引膨胀。

4. 可视化支持:内置 generate-dashboard.sh 生成 HTML 脑图仪表板,直观展示记忆分布与关联技能。

5. 模块化设计:作为 AI Brain 系列核心组件,可与 amygdala(情感)、VTA(动机)等技能协同,构建完整认知架构。

潜在缺点与局限性

1. 本地存储限制:所有数据仅存于 ~/.openclaw/workspace/,无云同步能力,设备迁移需手动备份。
2. 依赖外部 LLM:记忆编码和摘要生成依赖子 Agent 调用,可能产生额外 token 成本,且质量受底层模型影响。

3. 衰减参数固定:0.99 的日衰减系数不可调,对需要长期保留的关键记忆可能过于激进。

4. 无加密机制:敏感记忆以明文 JSON 存储,虽有隐私建议但缺乏原生加密选项。

5. 索引体积风险:长期运行后 index.json 可能膨胀,未内置自动归档或压缩机制。

适合的目标群体

  • 长期陪伴型 Agent 开发者:需要 Agent 记住用户偏好、历史对话和情感纽带的场景。
  • 个人知识管理用户:希望 AI 助手持续积累关于自身项目、人际关系和决策记录的高级用户。
  • AI 认知架构研究者:探索多模块协同(记忆-情感-动机)的实验性项目。
  • 隐私敏感型用户:拒绝云端记忆服务、坚持数据本地化的群体。

使用风险

  • 性能风险:大规模记忆索引(>10MB)可能拖慢 recall.sh 搜索速度,建议定期运行 consolidate.sh 整理。
  • 依赖项风险:依赖 python3jq,在精简环境中可能缺失;cron 任务失败会导致记忆堆积未处理。
  • 数据丢失风险signals.jsonlpending-memories.json 为临时文件,异常中断可能丢失未编码信号。
  • 隐私泄露风险:虽本地存储,但 HIPPOCAMPUS_CORE.mdbrain-dashboard.html 可能被误提交至 Git 仓库。

安全解读

核心用法

Hippocampus Memory 是一套为 AI 智能体设计的本地持久化记忆管理系统,灵感源自人脑海马体的记忆机制与斯坦福大学 Generative Agents 研究(Park et al., 2023)。系统通过自动化管道实现记忆的全生命周期管理:从对话信号提取、重要性评分、语义查重,到记忆强化/新建,再到基于时间的自然衰减。

核心工作流如下:
1. 信号预处理 (preprocess.sh):从对话记录提取关键信号

2. 编码管道 (encode-pipeline.sh):LLM 评估重要性 (0.0-1.0),语义比对现有记忆

3. 智能决策:相似主题自动强化(重要性+10%,更新访问时间),新主题创建摘要

4. 衰减机制 (decay.sh):每日应用 0.99^days 衰减公式,模拟遗忘曲线

5. 分级检索:0.7+ 核心记忆自动加载,0.4-0.7 主动检索,<0.2 归档候选

安装后提供可视化 Brain Dashboard,自动检测并整合 amygdala、VTA 等其他脑区技能,形成统一的认知架构视图。

显著优点

  • 学术背书:直接实现 Stanford Generative Agents 论文中的记忆机制,经过同行评审验证
  • 全自动运行:cron 任务驱动,每 3 小时编码、每日衰减,零人工干预
  • 智能防重复:语义层面识别相似记忆,自动强化而非创建冗余条目
  • 分层存储:user/self/relationship/world 四维分类,结构清晰
  • 零外部依赖:仅使用 python3、jq 系统工具,无第三方包供应链风险
  • 开源透明:MIT 协议,代码结构清晰,3,491 行可审计

潜在局限

  • T3 来源风险:个人开发者/社区项目维护,长期更新保障有限
  • 本地存储限制:无云同步机制,单设备使用,跨终端需手动迁移
  • 衰减参数固定:0.99 衰减系数不可配置,可能不适合所有记忆类型
  • LLM 成本:编码管道依赖 LLM 调用进行重要性评分和语义比对
  • 隐私集中化:所有对话记忆集中存储于本地 JSON 文件,需自行备份

适合人群

  • 追求 AI 代理长期一致性的高级用户
  • 需要本地优先、无云端依赖的隐私敏感场景
  • 研究 AI 认知架构的开发者与学者
  • 已使用或计划部署 OpenClaw/Claude 等代理框架的技术用户

常规风险

1. 数据丢失~/.openclaw/workspace/memory/index.json 为单一数据源,建议定期离线备份
2. 文件系统暴露:Skill 需读写用户主目录,安装时应确认路径配置正确

3. 记忆污染:若编码管道误判,可能强化错误记忆或创建低质条目,建议定期人工审查 HIPPOCAMPUS_CORE.md

4. Cron 任务残留--with-cron 安装后会在系统创建定时任务,卸载时需手动清理

hippocampus-memory 内容

agentdir文件夹
agents文件夹
prompts文件夹
scripts文件夹
templates文件夹
手动下载zip · 44.0 kB
AGENTS.mdtext/markdown
请选择文件