Hippocampus

🧠 AI 的长期记忆引擎

ai-brain榜 #1

斯坦福研究启发的 AI 记忆系统,自动捕获、评分、衰减和强化记忆,让智能体拥有持续身份认同。

收藏
22k
安装
5.5k
版本
3.7.2
CLS 安全性认证2026-06-24
点击查看完整报告 >

使用说明

核心用法

Hippocampus 是一套为 AI 智能体设计的背景记忆器官,独立运行于主代理之外,模拟人脑海马体的记忆形成机制。安装后通过 ./install.sh --with-cron 完成部署,自动设置定时任务。核心工作流包括:

1. 信号捕获preprocess.sh 从对话记录提取原始信号
2. 编码评分encode-pipeline.sh 为记忆打分(0.0-1.0),语义检查避免重复

3. 记忆衰减decay.sh 按 0.99^days 公式每日执行,模拟遗忘曲线

4. 智能检索recall.sh 支持重要性加权搜索

5. 核心加载load-core.sh 在会话开始时输出高重要性记忆

记忆按域分类存储(user/self/relationship/world),支持语义强化——当话题重复出现时自动提升重要性而非创建副本。

显著优点

  • 学术背书:直接基于 Stanford Generative Agents 论文(Park et al., 2023)实现
  • 全自动化:编码和衰减通过 cron 定时运行,无需手动干预
  • 语义智能:LLM 自动识别重复主题,避免记忆膨胀
  • 分层检索:0.7+ 为核心记忆(会话自动加载),0.4-0.7 为活跃记忆,<0.2 归档候选
  • 生态集成:与 OpenClaw RAG 深度整合,生成可视化 Brain Dashboard

潜在局限

  • 依赖外部工具:需 python3、jq 及 cron 环境,Windows 用户配置复杂
  • 评分主观性:重要性分数由 LLM 判断,可能漏捕用户认为关键的信息
  • 存储开销:长期运行后 index.json 可能膨胀,需定期 consolidate
  • 无原生加密:敏感记忆以明文存储于本地文件系统

适合人群

  • 构建长期陪伴型 AI 代理的开发者
  • 需要跨会话保持上下文的个人知识管理用户
  • 研究认知架构(cognitive architecture)的 AI 研究者

常规风险

  • 隐私泄露:记忆文件包含用户偏好、情感内容等敏感信息,需妥善保护 workspace 目录
  • 记忆污染:错误的重要评分可能导致噪声记忆长期驻留核心层
  • 衰减误伤:高频但间隔长的信息(如年度事件)可能被过度衰减
  • 依赖锁定:记忆格式与 OpenClaw 生态深度绑定,迁移成本较高

安全解读

核心用法

Hippocampus 是一套模拟人脑海马体功能的本地记忆管理系统,专为 AI 代理设计。它通过 shell 脚本与 Python 工具链,自动捕获对话信号、评估记忆重要性(0.0-1.0)、执行语义去重与强化,并应用时间衰减模型。核心工作流包括:预处理对话记录 → LLM 评分 → 语义检查 → 强化现有记忆或创建新记忆 → 每日衰减计算。用户可通过 recall.sh 进行语义检索,load-core.sh 加载高重要性记忆启动会话。

显著优点

  • 学术背书:直接基于 Stanford Generative Agents(Park et al., 2023)的记忆架构与衰减公式(0.99^days)
  • 零外部依赖:仅需 Python3 与 jq,无 npm/pip 包,供应链攻击面极小
  • 结构化存储:四级域分类(user/self/relationship/world),支持语义去重自动强化
  • 可视化治理:Brain Dashboard 自动检测并展示脑区技能(amygdala、VTA 等)运行状态
  • 隐私合规:GDPR 友好,数据完全本地存储,用户拥有完整控制权

潜在局限

  • 仅限 OpenClaw 生态:深度依赖 OpenClaw 的会话文件结构与 cron 系统,跨平台移植成本高
  • LLM 成本:每次编码需调用 LLM 进行重要性评分与摘要生成,高频对话场景可能产生显著 token 消耗
  • 无云端同步:本地单点存储,多设备使用时记忆无法同步
  • 字体 CDN 依赖:Dashboard 默认加载 Google Fonts,纯离线环境需手动修改

适合人群

  • 运行 OpenClaw 框架的 AI 代理开发者
  • 需要长期上下文连续性的个人助手用户
  • 对本地优先、隐私优先架构有强需求的用户
  • 认知架构研究者与 Agent 记忆系统爱好者

常规风险

| 风险项 | 等级 | 说明 |
|--------|------|------|
| 用户对话历史处理 | Low | 核心功能必需,本地处理无外发,已做长度限制与敏感信息过滤 |
| 外部 CDN 加载 | Low | Dashboard 使用 Google Fonts,仅加载字体无数据传输 |
| 数据持久化 | Info | 本地 JSON 存储,用户需自行备份防丢失 |
| 供应链安全 | Negligible | 零第三方依赖,仅使用系统标准工具 |

Hippocampus 内容

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