memory-lancedb-pro

🧠 AI代理的长期记忆中枢

Production-grade long-term memory system for OpenClaw AI agents with hybrid vector+BM25 retrieval, LLM-powered Smart Extraction, and Weibull decay lifecycle management.

收藏
6.3k
安装
3.1k
版本
1.0.0
CLS 安全性认证2026-05-06
点击查看完整报告 >

使用说明

memory-lancedb-pro 综合评估

核心用法

memory-lancedb-pro 是专为 OpenClaw AI 代理设计的生产级长期记忆 MCP 插件,基于 LanceDB 向量数据库构建。核心功能包括:

1. 智能记忆提取(Smart Extraction):通过 LLM 自动从对话中提取 6 类结构化记忆(preference/fact/decision/entity/reflection/other),支持 L0/L1/L2 分层内容生成
2. 混合检索(Hybrid Retrieval):融合向量相似度(70%)与 BM25 全文搜索(30%),配合交叉编码器重排序(cross-encoder reranking)实现高精度召回

3. 记忆生命周期管理:基于 Weibull 分布的三层衰减模型(Core/Working/Peripheral),支持访问强化和自动晋升/降级

4. 多作用域隔离:支持 global、agent:<id>、project:<id> 等多级记忆隔离

5. 自我改进治理:内置 LEARNINGS.md/ERRORS.md 日志系统和技能提取工具

MCP 工具集memory_recallmemory_storememory_forgetmemory_updatememory_statsmemory_list 为核心工具;self_improvement_logself_improvement_extract_skillself_improvement_review 为治理工具(需启用管理工具)。

显著优点

  • 检索精度领先:Jina v5 任务感知嵌入 + Jina reranker v3 交叉编码器组合,在 MTEB 基准上表现优异
  • 全自动记忆流水线:autoCapture(自动提取)+ autoRecall(自动注入)实现零手动干预
  • 生产级可靠性:支持多密钥故障转移、详细的配置验证、一键迁移工具
  • 隐私友好选项:完整支持 Ollama 本地部署,无需任何外部 API
  • 灵活配置:4 种预设配置方案(Full Power/Budget/Simple/Fully Local)适配不同场景

潜在缺点与局限性

  • 配置复杂度较高:20+ 个配置字段,新手容易遗漏 baseURL 大小写、/v1 后缀、plugins.allow 等关键细节
  • 本地模式性能 trade-off:Ollama 方案无交叉编码器重排序,检索精度显著低于云端方案
  • 资源消耗:推荐配置需同时维护 Jina + OpenAI 两个付费 API;本地模式需 8-16GB VRAM
  • Smart Extraction 依赖 LLM 质量:本地 LLM 可能出现 JSON 结构化输出失败,需降级为 smartExtraction: false
  • 网关重启依赖:任何配置变更都需要重启 OpenClaw Gateway,不支持热更新

适合人群

  • AI 代理开发者:需要为 OpenClaw 代理添加长期记忆能力的开发者
  • 多代理系统架构师:需要跨代理共享知识同时保持隔离的复杂场景
  • 隐私敏感用户:通过 Plan D(Ollama 本地方案)实现完全离线部署
  • 成本敏感团队:Plan B/C 提供逐步降级的成本优化路径

常规风险

  • API 密钥泄露风险:配置文件中需嵌入 ${ENV_VAR} 格式密钥,需确保网关进程环境变量正确设置
  • 数据迁移风险:从旧版 memory-lancedb 迁移时需使用专用命令,直接复制数据库文件会导致 schema 不兼容
  • jit 缓存污染:修改插件源码后必须清除 /tmp/jiti/ 缓存,否则可能运行旧代码
  • 记忆注入泄露:若代理提示词未正确设置,可能将 <relevant-memories> 内容直接输出给用户
  • 作用域配置错误:multi-scope 需要显式配置 scopes.agentAccess,否则代理只能访问 global 作用域

安全解读

核心功能概述

memory-lancedb-pro 是 OpenClaw AI 代理的生产级长期记忆系统 MCP 插件(v1.1.0-beta.8),基于 LanceDB 向量数据库构建。核心能力包括:

主要特性

  • 混合检索:向量搜索(0.7)+ BM25 全文搜索(0.3)融合,支持跨编码器重排序
  • 智能提取(Smart Extraction):LLM 驱动的 6 类自动分类(preference/fact/decision/entity/reflection/other),带 L0/L1/L2 三层内容结构化
  • 记忆生命周期管理:基于 Weibull 衰减的三层架构(Core/Working/Peripheral),支持访问强化和自动升降级
  • 多作用域隔离:global/agent/custom/project/user 多级作用域,支持显式访问控制映射
  • 自我改进治理:自动维护 LEARNINGS.md/ERRORS.md,支持技能提取和回顾工具

显著优点

1. 企业级检索质量:Jina + 交叉编码器重排序方案在 MTEB 基准上表现优异,候选池过滤 + MMR 多样性去重确保结果精准
2. 灵活部署模式:支持云端 API(Jina/OpenAI/SiliconFlow)和完全本地私有化(Ollama),零外部依赖方案满足 air-gapped 需求

3. 智能自动化:autoCapture/autoRecall 钩子自动完成记忆提取和注入,无需手动干预

4. 成熟运维工具:完整的 CLI 管理命令(list/search/stats/export/import/migrate/upgrade/reembed),支持从旧版 memory-lancedb 无缝迁移

潜在局限与风险

1. 配置复杂度:生产级调优涉及 50+ 参数,embedding/retrieval/decay/tier/scope 多层级配置易出错;字段大小写敏感(baseURLbaseUrl)是常见陷阱
2. 资源消耗:推荐配置(Jina embedding + 重排序 + GPT-4o-mini)产生三重 API 成本;本地模式(Plan D)需 16GB+ RAM 才能运行高质量模型

3. 冷启动问题:smartExtraction 需至少 2 轮对话才触发,新会话初期记忆为空

4. 本地 LLM 质量波动:Ollama 模式无交叉编码器重排序,且本地模型(除 qwen3:8b 外)可能产生无效 JSON 输出,需准备降级方案

适用人群

  • AI 代理开发者:需要为 Claude/ChatGPT 类代理添加持久化记忆能力
  • 企业 DevOps:部署隐私敏感或合规要求严格的内部 AI 系统
  • 多租户平台:需要 agent/project/user 级别记忆隔离的 SaaS 产品

常规风险管控

  • API 密钥通过 ${ENV_VAR} 注入,避免硬编码;定期轮换并启用用量监控
  • 生产部署前务必执行 openclaw config validateopenclaw doctor 健康检查
  • 修改插件代码后必须清除 jiti 缓存(rm -rf /tmp/jiti/)再重启网关
  • 建议维护配置版本控制,利用 --dry-run 参数预览迁移/升级操作

memory-lancedb-pro 内容

references文件夹
手动下载zip · 27.3 kB
full-reference.mdtext/markdown
请选择文件