SuperAPI AI 工具集

elite-longterm-memory

智能体与模型

查看项目

更新于 10-15 10:23

技能介绍

用途

Elite Longterm Memory 是一套为 AI 智能体设计的长期记忆系统,面向 Cursor、Claude、ChatGPT 与 Copilot 等使用场景。它把六种已被验证的记忆方案整合进一个分层架构,核心目标是:不丢失上下文、不遗忘决策、不重复犯错。

架构与主要能力

系统采用分层结构,从快到慢、从临时到持久:

  • 热内存(HOT RAM):以 SESSION-STATE.md 作为智能体的活动工作记忆,可在上下文压缩(compaction)后存活。采用 WAL(Write-Ahead Log,预写日志)协议,在回复用户之前先写入状态。
  • 温存储(WARM STORE):基于 LanceDB 向量,提供跨全部记忆的语义搜索,自动召回会把相关上下文注入对话。
  • 冷存储(COLD STORE):基于 Git-Notes 的知识图谱,保存结构化决策、经验与上下文,并具备分支感知能力。
  • 人工整理归档(CURATED ARCHIVE):MEMORY.md 加每日日志(memory/YYYY-MM-DD.md)与主题文件,是人类可读的长期记忆。
  • 云端备份(CLOUD BACKUP):可选的 SuperMemory,用于跨设备同步,并可与知识库对话。
  • 自动抽取(AUTO-EXTRACTION):可选的 Mem0,自动从对话中抽取事实,据称可减少 80% 的 token 消耗,并自动去重与更新已有记忆。

使用方式

快速搭建步骤(来自资料):

  1. 创建 SESSION-STATE.md(热内存),包含当前任务、关键上下文、待办动作、近期决策等区块。
  2. 启用 LanceDB(温存储):在 ~/.openclaw/openclaw.json 中配置 memorySearch(enabled、provider、sources、minScore、maxResults)以及 memory-lancedb 插件(autoCapture、autoRecall、captureCategories、minImportance)。
  3. 初始化 Git-Notes(冷存储):在项目目录执行 git init,并运行 python3 skills/git-notes-memory/memory.py -p . sync --start。
  4. 确认 MEMORY.md 结构:工作区根目录有 MEMORY.md,并创建 memory/ 目录用于每日日志。
  5. 可选:设置 SuperMemory,导出 SUPERMEMORY_API_KEY。

智能体行为约定:会话开始时读取 SESSION-STATE.md、执行 memory_search、检查当日日志;对话中若用户给出具体细节或做出决策,先写入 SESSION-STATE.md 再回复,重要决策静默存入 Git-Notes,偏好以 importance=0.9 存入;会话结束时更新 SESSION-STATE.md、把重要内容移入 MEMORY.md、创建或更新每日日志。

WAL 协议是核心:用户表达偏好、做出决策、给出截止时间或纠正智能体时,都应先写状态再回复,以保证在崩溃或压缩前状态已持久化。

维护命令包括:memory_recall 审计向量、删除 LanceDB 目录并重启网关、导出 Git-Notes 为 JSON、检查记忆目录大小与日志行数等。资料还建议每周做记忆卫生:归档已完成任务、清理无关向量、把每日日志合并进 MEMORY.md。

适用场景

适合需要跨会话保持上下文的智能体工作流,例如长期项目协作、偏好与决策追踪、多设备同步、以及希望减少重复历史 token 的对话系统。

限制与注意事项

部分能力依赖外部服务与密钥:语义搜索需要 OpenAI 密钥,云端备份需要 SuperMemory API Key,自动抽取需要 Mem0 API Key。资料列出了常见失败模式与修复方式,例如记忆搜索未启用、智能体跳过读取记忆文件、子智能体不继承上下文、经验未记录导致重复犯错等。Git-Notes 若未持久化,需要执行 git notes push 同步远端。

相关链接

  • bulletproof-memory: https://clawdhub.com/skills/bulletproof-memory
  • lancedb-memory: https://clawdhub.com/skills/lancedb-memory
  • git-notes-memory: https://clawdhub.com/skills/git-notes-memory
  • memory-hygiene: https://clawdhub.com/skills/memory-hygiene
  • supermemory: https://clawdhub.com/skills/supermemory