很多智能体第一次对话很聪明,换一个会话却像重新认识你:代码风格、项目决策、人物关系和长期偏好都要再解释一遍。memory-lancedb-pro正是为OpenClaw补上这块能力,它把重要信息存入LanceDB,并在后续任务开始前自动找回相关记忆。

memory-lancedb-pro是什么?
这是CortexReach维护的OpenClaw开源插件,定位不是简单的聊天记录搜索,而是一套面向生产使用的智能体长期记忆系统。它可以自动捕获偏好、实体、事件、案例和行为模式,在合适的任务中召回,并通过管理工具完成统计、删除、备份、迁移与重新向量化。
项目采用MIT协议,当前主线正在适配OpenClaw 2026.3+的新插件架构。仓库包版本已进入1.1.0 beta系列,功能更新很快,部署生产环境时需要固定版本并阅读变更记录。
为什么普通聊天历史还不够
把所有旧对话直接塞进提示词会迅速占满上下文,也会让无关闲聊干扰当前任务。真正实用的记忆系统需要决定哪些内容值得保存、以什么结构保存、什么时候检索,以及旧信息何时降权或合并。
memory-lancedb-pro通过自动捕获和智能提取把会话中的信息整理成可检索记忆,再依据当前问题挑选少量相关片段注入提示词。这样既减少重复说明,也避免每次加载完整历史。
向量与BM25混合检索
插件同时使用向量语义检索和BM25全文搜索。向量检索擅长找到表达不同但含义相近的内容,BM25则更容易命中项目名、函数名、错误码和专有术语。两路结果融合后,再进入后续评分流程。
可选的交叉编码器会重新判断查询与候选记忆的相关性,支持Jina、SiliconFlow、Voyage AI、Pinecone及兼容端点。外部重排失败时可以降级到余弦相似度,避免整个召回流程因单个服务不可用而中断。
不仅记住,还会让噪声逐渐淡出
长期记忆最怕只增不减。插件使用基于时间、访问频率、重要性和置信度的生命周期评分,并引入Weibull衰减模型。经常被使用或被标记为重要的内容保留更久,低价值噪声则逐渐降低权重。
三层记忆机制会在Core、Working和Peripheral之间升降,配合长度归一化、最低分过滤与多样性处理,减少重复条目和超长文本对结果的挤占。这个设计比单纯的“写入向量库再搜相似度”更接近长期运行需求。
自动捕获与六类智能提取
开启autoCapture和smartExtraction后,插件可以从对话中识别个人资料、偏好、实体、事件、案例与模式,不需要用户每次手动调用memory_store。提取内容采用分层表达:简短索引用于快速匹配,结构化摘要用于判断,完整叙述则保留细节。
写入前还会进行相似度预筛和语义去重,决定新建、合并或跳过,降低同一偏好被反复保存的问题。自动化越强,越需要定期抽查记忆质量,避免错误结论被长期强化。
两层记忆架构
插件把LanceDB记忆和OpenClaw的规范文件组合使用。LanceDB负责语义索引和高效召回,MEMORY.md、memory目录、会话记录及其他公开记忆文件仍可作为可读、可审计的事实来源。
这种架构保留了文件记忆的透明度,又获得向量搜索能力。召回结果可以携带路径、行号、片段、来源与引用,方便智能体说明某条记忆从何而来,也方便用户回到原文件核验。
用户、项目与智能体隔离
项目内置global、agent、user、project和custom等作用域,可以把不同客户、团队、机器人和项目的记忆分开。对于同时运行多个OpenClaw智能体的环境,这比在一个向量表里混合所有数据安全得多。
作用域只是访问控制的一部分。生产部署还需要限制数据库文件权限、保护API密钥、规划备份位置,并测试工具调用能否越权读取其他用户或项目的数据。
模型提供商与本地化选择
Embedding接口兼容OpenAI、Jina、Gemini、Ollama和其他OpenAI格式服务,重排与智能提取也可单独配置。团队可以在效果、速度、成本和数据边界之间组合,例如云端Embedding配本地提取,或完全使用本地Ollama。
要注意,数据库存于本地不代表所有文本都只在本机处理。只要调用外部Embedding、重排或LLM服务,相应内容就可能离开服务器。涉及客户资料与内部决策时,应先确认提供商条款和数据保留策略。
安装与版本要求
项目提供一键安装脚本,也可以通过OpenClaw插件命令或npm安装。完成后需要把它绑定到OpenClaw的memory插槽,写入Embedding配置,验证配置并重启Gateway,再从日志确认自动提取与插件注册成功。
当前新架构要求OpenClaw 2026.3.22或更高版本,并使用before_prompt_build等新钩子。升级后建议运行openclaw doctor –fix。CPU至少需要AVX指令,部分缺少AVX2的Linux机器还要关闭LanceDB原生余弦检索以避开SIGILL崩溃。
管理CLI与备份迁移
memory-pro命令可以列出、搜索、统计、删除、批量清理、导出、导入、重新嵌入和升级记忆。对于准备长期运行的智能体,这些运维能力非常关键,因为记忆数据也需要像数据库一样可检查、可迁移和可恢复。
正式升级前应先导出备份,执行dry-run,再核对不同作用域的条目数量和召回结果。Embedding模型维度变化时通常需要重新向量化,不能简单替换模型名称后继续使用旧向量。
实际体验与综合评价
memory-lancedb-pro的亮点不是某一个检索算法,而是把采集、提取、去重、检索、重排、衰减、隔离和运维串成完整链路。对经常处理长期项目的OpenClaw用户,它能明显减少重复交代背景,并让历史决策更容易追溯。
代价是配置复杂度和持续维护。Embedding、重排、智能提取、阈值、作用域与模型成本都会影响最终体验。默认方案适合快速开始,但生产环境仍应建立评测集,观察错误召回、漏召回、写入噪声和上下文占用。
适合哪些用户?
- OpenClaw重度用户:希望智能体跨会话记住个人偏好与长期任务。
- 开发团队:需要保留架构选择、编码规范、故障案例和项目上下文。
- 多智能体系统:需要按用户、项目与Agent隔离记忆并统一管理。
- 本地AI爱好者:希望使用LanceDB与Ollama构建可控的私有记忆。
- 智能体平台开发者:研究混合检索、记忆衰减和语义索引的工程实现。
优点与注意事项
优点:自动捕获和召回;向量与BM25混合检索;支持交叉编码器重排;具备智能遗忘和分层记忆;多作用域隔离;提供CLI、备份与迁移工具;模型提供商选择灵活。
注意事项:当前beta功能仍在快速变化;需满足OpenClaw与CPU版本要求;外部模型服务可能接触记忆文本;错误记忆会影响后续回答;生产升级前必须备份并验证召回质量。
总结
如果你只想偶尔保存一条提醒,简单文件记忆已经够用;如果OpenClaw要长期参与项目、服务多个用户,并在大量历史里找到真正相关的偏好与决策,memory-lancedb-pro提供了更完整的工程方案。它值得尝试,但也应像管理数据库和知识库一样认真管理,而不是装好后完全放任自动运行。

