memory-qdrant

使用场景当您需要您的OpenClaw智能体在多轮对话中通过语义搜索来记忆和回忆信息时使用。

由Qdrant向量数据库和Transformers.js嵌入模型驱动的本地语义记忆插件。零配置，完全本地化，无需API密钥。

功能特性

• 基于本地Transformers.js嵌入模型的语义搜索
• 内存模式（零配置）或持久化Qdrant存储
• 可选的对话上下文自动捕获功能（需手动启用，默认关闭）
• 上下文感知的记忆回忆
• 完全本地化，无需API密钥或外部服务

安装说明

clawhub install memory-qdrant

首次设置：此插件首次运行时将从Hugging Face下载一个25MB的嵌入模型，并且可能需要为原生依赖项（sharp、onnxruntime）安装构建工具。详情请参阅README文件了解详细的安装要求。

配置说明

在您的OpenClaw配置中启用：

{
  "plugins": {
    "memory-qdrant": {
      "enabled": true
    }
  }
}

选项：

• 自动捕获（默认值：false）- 自动记录对话。注意：触发模式包括电子邮件/电话正则表达式，因此启用此功能可能会捕获个人身份信息。
• 自动回忆（默认值：true）- 自动注入相关记忆
• qdrantUrl（可选）- 外部 Qdrant 服务器（留空则使用内存模式）

使用

提供三种工具：

memory_store- 保存信息

memory_store({
  text: "User prefers Opus for complex tasks",
  category: "preference"
})

memory_search- 查找相关记忆

memory_search({
  query: "workflow preferences",
  limit: 5
})

memory_forget- 删除记忆

memory_forget({ memoryId: "uuid" })
// or
memory_forget({ query: "text to forget" })

隐私与安全

• 内存模式（默认）：重启时数据将被清除
• Qdrant 模式：数据发送到配置的服务器（仅使用受信任的服务器）
• 网络：首次运行时从 Hugging Face 下载约 25MB 的模型
• autoCapture默认禁用以保护隐私。触发模式会匹配电子邮件和类似电话号码的格式，因此启用自动捕获可能会捕获个人身份信息。

技术细节

• 向量数据库：Qdrant（内存或外部存储）
• 嵌入模型：Xenova/all-MiniLM-L6-v2（本地部署）
• 模块：ES6，采用工厂函数模式

链接

• GitHub：https://github.com/zuiho-kai/openclaw-memory-qdrant
• 问题反馈：https://github.com/zuiho-kai/openclaw-memory-qdrant/issues