Memory Indexer 🧠

> 短期记忆关键词索引工具，为 AI Agent 提供长期记忆能力

版本: v2.0.0

简介

Memory Indexer 帮助 AI Agent 持久化记忆：

• 自动提取记忆中的关键词
• 建立关键词 → 记忆文件的快速索引
• 支持多关键词精确搜索（AND/OR 模式）
• 自动发现关联记忆
• 按时间线展示记忆
• 标记和查看重要记忆
• 增量同步外部记忆目录
• 会话备份与精简（避免 session memory 无限膨胀）

功能特性

1. 自动关键词提取：使用 jieba 中文分词
2. 多模式搜索：OR（任一匹配）/ AND（全部匹配）
3. 关联发现：自动发现经常一起出现的记忆
4. 时间线视图：按时间顺序展示记忆
5. 主动提醒：根据当前关键词提示相关旧记忆
6. 重要记忆标记：手动标记优先保留
7. 增量同步：只索引新增或修改的文件
8. 失效清理：自动清理已删除记忆的索引
9. 三级级联搜索：关键词 → 向量语义 → 原文，自动降级
10. 向量语义搜索：基于 HuggingFace bge-base-zh-v1.5 模型
11. 会话备份与精简：备份用户消息到索引，精简 session 文件到 ~10KB
12. Memory 文件精简：备份 memory/*.md 到索引，精简大文件到 ~10KB
13. 新对话自动搜索：Hook 机制，新会话开始时自动检索相关记忆
14. 压缩风险检测：检测 memory 目录大小，评估压缩风险
15. 使用统计：查看 memory 文件数量、大小、关键词统计
16. 快照备份：压缩前自动/手动创建快照，支持恢复

安装

方式一：运行安装脚本（推荐）

git clone https://github.com/smallmj/memory-indexer.git
cd memory-indexer
chmod +x install.sh
./install.sh

方式二：手动安装

git clone https://github.com/smallmj/memory-indexer.git
cd memory-indexer
pip install -r requirements.txt
ln -sf "$(pwd)" ~/.openclaw/workspace/skills/memory-indexer
python3 memory-indexer.py status

快速开始

# 添加记忆
python memory-indexer.py add "今天学习了 Python"

# 搜索（OR 模式）
python memory-indexer.py search "Python"

# 搜索（AND 模式）
python memory-indexer.py search "Python 编程" --and

# 列出所有记忆
python memory-indexer.py list

# 记忆摘要
python memory-indexer.py summary

向量语义搜索（需要安装依赖）

# 安装向量模型依赖
pip install sentence-transformers

# 测试向量生成
python embedding.py test

# 查看向量索引状态
python embedding.py status

# 批量生成历史记忆的向量
python embedding.py reindex

# 三级级联搜索（默认）
python memory-indexer.py search "今天天气"

Hook: 新对话自动搜索记忆

从 v2.0.0 开始，提供 OpenClaw Hook memory-indexer-on-new，在新对话开始时自动搜索相关记忆。

# 复制 Hook 目录到 OpenClaw
cp -r hooks/memory-indexer-on-new ~/.openclaw/hooks/

# 重启 Gateway 使其生效
openclaw gateway restart

命令参考

配置

数据目录：~/.memory-indexer/

~/.memory-indexer/
├── index.json          # 关键词索引
├── sync-state.json    # 同步状态
└── stars.json         # 重要记忆标记

依赖

• Python 3.8+
• jieba (中文分词)

License

MIT