hippocampus-memory

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

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

收藏
899
安装
331
版本
v3.8.6
CLS 安全性认证2026-04-30
点击查看完整报告 >

使用说明

核心用法

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 是一款为 AI Agent 设计的持久化记忆系统,灵感源自人脑海马体,实现记忆的自动捕获、结构化存储与智能衰减。系统基于 Stanford Generative Agents(Park et al., 2023)研究,通过 Shell 脚本与 Python 工具链,将对话历史转化为可检索的记忆资产。

显著优点

1. 自动记忆编码:无需人工干预,从对话流中自动提取关键信号(preferences、decisions、emotional moments),并生成带重要性评分的记忆条目
2. 语义强化机制:LLM 自动识别重复话题,对既有记忆进行强化(提升重要性 10%)而非重复创建,避免记忆膨胀

3. 生物学启发的衰减模型:采用 0.99^days 衰减公式,90 天未访问记忆自动降至 40% 权重,模拟真实遗忘曲线

4. 四级记忆分层:Core(0.7+,会话启动加载)、Active(0.4-0.7)、Background(0.2-0.4)、Archive(<0.2),检索效率与相关性平衡

5. 多域结构化存储:user/self/relationship/world 四维分类,支持身份认同、用户画像、关系上下文与外部知识的分离管理

6. 零外部依赖:仅依赖 python3 与 jq 系统工具,完全离线运行,无 API 密钥、无网络请求

7. 可视化脑仪表盘:自动生成 HTML 仪表盘,集成同系列脑技能(amygdala、VTA 等)的状态监控

潜在局限与风险

1. T3 来源等级:由 GitHub 个人开发者 ImpKind 维护,虽代码开源透明,但缺乏企业级背书与长期维护承诺
2. 本地数据积累风险:长期运行后 memory/index.json 可能膨胀,需定期运行 consolidate.sh 与 decay.sh 维护

3. 敏感信息残留:对话中提取的摘要可能包含用户隐私数据,需手动设置目录权限(chmod 700/600)并避免意外 git 提交

4. 衰减参数固定:0.99 日衰减系数与 0.2/0.4/0.7 阈值不可配置,可能不适应特定场景的遗忘速度需求

5. 跨会话一致性依赖:依赖 cron 定时任务(每 3 小时编码/每日衰减),若环境不支持 cron 需手动触发

适合人群

  • 构建长期陪伴型 AI Agent 的开发者,需要跨会话身份连续性
  • 研究 Generative Agents、认知架构的学术与实验用户
  • 对数据隐私敏感、偏好完全本地化方案的个人用户
  • 已使用 OpenClaw 框架、希望扩展记忆 RAG 能力的现有用户

常规风险提示

  • 数据备份:index.json 为单一核心数据源,建议配置自动备份策略
  • 权限隔离:记忆文件含对话摘要,应严格限制文件系统权限
  • 版本锁定:社区项目更新可能引入破坏性变更,生产环境建议锁定版本并审查 CHANGELOG

hippocampus-memory 内容

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