核心用法
Lily Memory 是面向 OpenClaw 智能体生态的持久化记忆插件,通过 SQLite FTS5 关键词索引与 Ollama 向量语义搜索的双引擎架构,实现对话上下文的自动召回与事实捕获。插件采用零 npm 依赖设计,仅依赖 Node.js 18+ 的原生 fetch 与系统级 sqlite3 CLI,兼顾轻量部署与功能完整性。
显著优点
1. 混合检索能力:FTS5 关键词搜索与 Ollama 向量余弦相似度计算相结合,兼顾精确匹配与语义泛化能力, recall 精度显著优于单一检索模式
2. 自动化工作流:Auto-recall 在每轮 LLM 调用前注入相关记忆,Auto-capture 通过正则解析 entity: key = value 模式自动提取结构化事实,降低人工干预成本
3. 智能循环检测:基于 Jaccard 相似度监测连续响应的内容重复率,当 3 轮以上重叠度超 60% 时触发 Reflexion 提示,有效打破对话死循环
4. 弹性架构设计:Ollama 不可用时自动降级为纯关键词模式;启动时自动执行记忆去重合并;支持运行时动态扩展实体类型
5. 运维友好性:零 npm 依赖消除供应链攻击面,MIT 协议授权,配置驱动且工具接口清晰
潜在局限与风险
- 外部依赖耦合:向量功能依赖本地 Ollama 服务及
nomic-embed-text模型,跨平台部署需确保模型可用性 - 正则解析局限:事实捕获依赖固定正则模式,非结构化或复杂句式提取准确率受限
- 隐私与数据安全:SQLite 数据库存储于本地文件系统,多用户场景下需额外设计访问控制;向量嵌入过程需传输至 Ollama,存在本地隐私泄露风险
- 规模瓶颈:SQLite 单文件架构在高并发写入或超大规模记忆场景下可能出现性能衰减
- 生态绑定:专为 OpenClaw 设计,与其他 Agent 框架的兼容性未经验证
适合人群
OpenClaw 智能体开发者、需要长期上下文保持的对话系统构建者、注重轻量级部署与离线运行的技术团队,以及对 npm 供应链安全敏感的企业环境。
常规风险提示
建议在正式部署前验证 sqlite3 与 fts5 扩展的可用性,定期备份 .db 文件,敏感场景下评估向量嵌入的本地隔离需求。