简介

Memory-LanceDB-Pro 是 CortexReach 团队为 OpenClaw(原 Clawdbot/Moltbot)框架开发的一款企业级长期记忆插件。它旨在彻底解决 AI 代理在跨会话、跨时间交互中的“失忆”问题。传统的 AI 代理通常受限于上下文窗口,一旦对话结束或重启,历史信息便荡然无存。该插件基于高性能的 LanceDB 向量数据库,通过智能提取、混合检索与生命周期管理,将 AI 代理从“健忘的聊天机器人”升级为拥有持久化经验库的“智能助手”。

主要功能

  • 智能记忆提取:利用 LLM 自动从对话中提取并分类重要信息,无需手动标记。支持六大类别:用户画像(Profile)、偏好(Preferences)、实体(Entities)、事件(Events)、案例(Cases)和模式(Patterns)。

  • 混合检索引擎:结合向量语义搜索(ANN)与 BM25 全文检索,并引入跨编码器(Cross-Encoder)重排序,确保召回结果既语义相关又关键词精确。

  • 记忆生命周期管理:采用 Weibull 衰减模型与三层晋升系统(Peripheral → Working → Core),高频访问的重要记忆衰减慢,低频噪音自然淡出,防止记忆库无限膨胀。

  • 多 Scope 隔离:支持全局(Global)、代理(Agent)、用户(User)、项目(Project)等多维度记忆隔离,确保不同场景下的记忆互不干扰。

  • 自动捕获与回忆:开启 autoCaptureautoRecall后,插件会在对话结束时自动提炼记忆,并在新对话开始前自动注入相关上下文。

  • 生产级运维:提供完整的 CLI 工具链,支持记忆的备份、迁移、统计、删除及数据库升级。

安装与配置

安装方式

推荐方式(一键脚本)

curl -fsSL https://raw.githubusercontent.com/CortexReach/toolbox/main/memory-lancedb-pro-setup/setup-memory.sh -o setup-memory.sh
bash setup-memory.sh

手动安装(OpenClaw CLI)

openclaw plugins install memory-lancedb-pro@beta

核心配置

openclaw.jsonplugins.entries中添加以下配置,以启用智能提取与混合检索:

{
  "plugins": {
    "slots": {
      "memory": "memory-lancedb-pro"
    },
    "entries": {
      "memory-lancedb-pro": {
        "enabled": true,
        "config": {
          "embedding": {
            "provider": "openai-compatible",
            "apiKey": "${OPENAI_API_KEY}",
            "model": "text-embedding-3-small"
          },
          "autoCapture": true,
          "autoRecall": true,
          "smartExtraction": true,
          "retrieval": {
            "mode": "hybrid",
            "rerank": "cross-encoder"
          }
        }
      }
    }
  }
}

验证安装:重启 OpenClaw 网关后,执行 openclaw memory-pro stats查看记忆库状态。

如何使用

安装配置完成后,插件将在后台自动运行。用户无需手动干预即可享受记忆服务:

  1. 自然交互:在对话中提及偏好(如“我习惯用 tabs 缩进”)或重要事实(如“项目数据库是 PostgreSQL”),插件会自动捕获并存储。

  2. 主动查询:在后续会话中,直接询问“我之前说过喜欢什么编辑器?”或“上次那个 bug 是怎么解决的?”,代理会从 LanceDB 中检索出精确答案。

  3. 管理记忆:使用 CLI 命令进行高级管理:

    • openclaw memory-pro list:列出所有记忆条目。

    • openclaw memory-pro search "query":搜索特定记忆。

    • openclaw memory-pro delete <id>:删除无效记忆。

应用场景实例

实例 1:个性化开发助手

场景:开发者 Alex 在多个项目中切换,每次都需要重新告知代理自己的编码风格。

  • 使用前:每次新会话,Alex 都要重复说“用 Prettier 格式化”、“禁用 console.log”、“函数名用 camelCase”。

  • 使用后:Alex 在第一次对话中设定偏好后,后续所有代码生成任务,代理自动应用这些规则,无需重复指令。

实例 2:跨期项目复盘

场景:项目经理回顾三个月前关于“架构选型”的讨论细节。

  • 使用前:历史聊天记录早已被压缩或丢失,无法追溯当时的权衡理由。

  • 使用后:输入“为什么当时选择微服务而不是单体?”,代理立即调出当时的决策记录,包括选择的利弊分析和技术栈对比。

实例 3:客服知识库演进

场景:电商客服代理处理退货政策咨询。

  • 使用前:政策更新后,旧对话中的过时信息可能被误检索。

  • 使用后:插件的时间衰减机制自动降低旧政策条目的权重,新政策条目优先被召回,确保回答的时效性。

GitHub 地址

项目仓库https://github.com/CortexReach/memory-lancedb-pro

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐