skills/impkind/Hippocampus

Hippocampus

🧠 AI 智能体的持久记忆引擎

agent-cognition榜 #1

AI 智能体长期记忆系统，基于斯坦福 Generative Agents 研究，自动编码、重要性评分、语义强化与衰减管理，实现跨会话身份连续性

收藏
13.2k
安装
3.3k
版本
3.8.3
CLS 安全性认证2026-05-17
点击查看完整报告 >

使用说明

核心用法

Hippocampus 是一套完整的 AI 智能体记忆基础设施，模拟人脑海马体的记忆形成机制。系统通过信号提取→重要性评分→语义查重→强化或创建→定时衰减的完整生命周期，实现结构化持久记忆。

关键工作流：
1. 信号捕获：从对话记录自动提取潜在记忆信号
2. 智能编码：LLM 评估重要性（0.0-1.0），自动合并相似记忆而非重复创建
3. 分层存储：按 user/self/relationship/world 四维分类管理
4. 衰减机制：每日应用 0.99^days 衰减公式，模拟自然遗忘
5. 核心加载：0.7+ 分记忆自动注入会话启动，确保身份连续性

技术亮点：语义强化机制——当话题重复出现时，系统自动识别并强化既有记忆而非创建碎片，这是解决 LLM 长期记忆"膨胀-遗忘"问题的关键设计。

显著优点

  • 学术背书：直接基于 Park 等 2023 年斯坦福 Generative Agents 研究，理论扎实
  • 自动化程度高：cron 驱动，编码/衰减/仪表盘生成无需人工干预
  • 模块化架构：与 amygdala（情绪）、VTA（奖励）等脑区组件可组合扩展
  • OpenClaw 原生集成：RAG 桥接、AGENTS.md 即插即用
  • 视觉仪表盘：统一 brain-dashboard.html 可视化记忆全景

潜在局限与风险

  • 依赖外部 LLM：编码/评分需调用 LLM，成本与延迟需权衡
  • 衰减公式刚性：固定 0.99 指数可能不适合所有场景，缺乏自适应调整
  • 存储格式封闭：index.json 非标准向量格式，跨平台迁移需转换
  • 隐私集中化：记忆明文存储于本地 workspace，多设备同步需自行解决
  • 社区维护：v3.8.3 版本，长期演进依赖社区活跃度

适合人群

  • 构建长期陪伴型 AI 智能体的开发者
  • 需要跨会话身份一致性的 Agent 框架用户
  • 对认知架构（cognitive architecture）感兴趣的 AI 研究者
  • OpenClaw 生态深度用户

常规风险

  • 数据丢失：未配置备份时，workspace 损坏将导致记忆全失
  • 重要性评分漂移：不同 LLM 对同一条记忆可能给出差异显著的重要性分数
  • 强化过度：高频话题可能因反复强化而压制其他重要但低频记忆
  • cron 任务堆积：高频率编码在对话密集场景可能产生处理队列

安全解读

核心用法

Hippocampus 是一个模拟人类大脑海马体功能的本地持久化记忆系统，专为 AI Agent 设计。其核心工作流包含：

1. 信号预处理 (preprocess.sh)：从对话记录提取潜在记忆信号
2. 编码管道 (encode-pipeline.sh)：LLM 自动评分(0.0-1.0)、语义查重、强化或创建新记忆
3. 时间衰减 (decay.sh)：按 0.99^天数 公式降低未访问记忆的重要性
4. 智能召回 (recall.sh)：基于重要性加权搜索，高优先级记忆自动加载至会话启动

记忆按四大域分类存储：user/(用户事实)、self/(Agent身份)、relationship/(共享历史)、world/(外部知识)，通过 index.json 统一索引。

显著优点

  • 学术背书：直接实现斯坦福《Generative Agents》论文(Park et al., 2023)的内存架构
  • 零外部依赖：仅使用 python3、jq、bash，无第三方包供应链风险
  • 隐私优先：所有数据本地存储于 ~/.openclaw/workspace/，符合 GDPR/CCPA
  • 智能去重：语义强化机制自动识别重复话题，避免记忆膨胀
  • 可视化仪表板：自动生成 HTML 脑图，整合同系列其他脑区技能

局限与风险

  • T3来源可信度：个人开发者项目(ImpKind)，非顶级基金会背书
  • 文件系统权限：需读写用户主目录，虽限制在工作目录内但仍需信任
  • Cron自动执行：安装时可选设置定时任务，需理解其持续后台行为
  • Google Fonts CDN：仪表板引用外部字体，纯离线环境需手动修改
  • 记忆质量依赖LLM：编码准确性受底层模型能力影响，可能产生语义偏差

适合人群

  • 需要长期身份连续性的个性化 AI Agent 开发者
  • 研究认知架构和 Agent 记忆系统的技术探索者
  • 对数据隐私敏感、拒绝云端记忆服务的用户
  • 已使用或计划构建"AI Brain"多脑区系统的进阶玩家

常规风险提示

  • 建议定期备份 memory/index.json，尽管脚本自带备份机制
  • 执行 install.sh 前建议审查脚本，了解其创建的目录和 cron 任务
  • 高重要性阈值(0.7+)的记忆会被自动加载，需注意敏感信息沉淀
memory-systemgenerative-agentsagent-architecturecognitive-computingpersistenceragopenclawstanford-research

Hippocampus 内容

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