概述

memory-lancedb 是 OpenClaw 内置的记忆插件,将长期记忆存储在 LanceDB 向量数据库中,使用 embedding 进行语义召回。支持自动召回(对话前注入相关记忆)和自动捕获(回复后保存重要事实)。通过 plugins.slots.memory = "memory-lancedb" 激活为主动记忆插件。

核心功能

  • 向量存储:基于 LanceDB,默认路径 ~/.openclaw/memory/lancedb,支持 S3 等远程存储后端
  • 多 Embedding 提供商:OpenAI、GitHub Copilot、Ollama(原生 /api/embed 端点)、任意 OpenAI 兼容端点
  • 自动召回/捕获:autoRecall 在模型轮次前召回相关记忆;autoCapture 在回复后自动保存
  • 文本长度限制:recallMaxChars(默认 1000,用于 embedding 请求)和 captureMaxChars(默认 500,控制捕获资格)
  • CLI 命令:openclaw ltm list/search/stats,openclaw memory query(支持 SQL 风格过滤)
  • Agent 工具:memory_recall、memory_store、memory_forget

配置/使用

最小配置(OpenAI embedding):

{
  plugins: {
    slots: { memory: "memory-lancedb" },
    entries: {
      "memory-lancedb": {
        enabled: true,
        config: {
          embedding: { provider: "openai", model: "text-embedding-3-small" },
          autoRecall: true,
          autoCapture: false
        }
      }
    }
  }
}

Ollama 本地 embedding:

{
  embedding: {
    provider: "ollama",
    baseUrl: "http://127.0.0.1:11434",
    model: "mxbai-embed-large",
    dimensions: 1024
  },
  recallMaxChars: 400
}

注意:openai-codex OAuth 不是 OpenAI Platform embedding 凭证,需使用 OpenAI API key 或其他支持 embedding 的提供商。

相关页面

  • memory — 记忆系统总览
  • active-memory — 主动记忆机制
  • memory-search — 记忆搜索算法
  • concepts/plugin-memory-wiki — Memory Wiki 知识库插件(可与 LanceDB 并存)