memory-qdrant

适用场景：当您需要 OpenClaw agent 在跨会话交互中记忆并基于语义搜索召回信息时使用。

基于 Qdrant 向量数据库与 Transformers.js 嵌入模型实现的本地语义记忆插件。零配置、完全本地运行，无需 API 密钥。

特性

• 使用本地 Transformers.js 生成嵌入向量进行语义搜索
• 支持内存模式（零配置）或持久化 Qdrant 存储
• 可选自动捕获对话上下文（需显式启用，默认禁用）
• 上下文感知的记忆召回能力
• 完全本地化，无需 API 密钥或外部服务

安装

clawhub install memory-qdrant

首次设置说明：该插件在首次运行时将从 Hugging Face 下载约 25MB 的嵌入模型，并可能需要构建工具以编译原生依赖（如 sharp、onnxruntime）。详细安装要求请参阅 README 文档。

配置

在您的 OpenClaw 配置文件中启用该插件：

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

可选配置项：

• autoCapture（默认值：false）—— 自动记录对话内容。注意：触发规则包含邮箱与电话号码正则匹配，启用后可能捕获个人身份信息（PII）。
• autoRecall（默认值：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" })
// 或
memory_forget({ query: "text to forget" })

隐私与安全

• 内存模式（默认）：数据在进程重启后自动清除
• Qdrant 模式：数据发送至指定服务器（请仅使用可信服务器）
• 网络行为：首次运行时从 Hugging Face 下载约 25MB 模型文件
• autoCapture：为保障隐私，默认禁用。由于触发规则匹配邮箱及类电话号码格式，启用 autoCapture 可能导致个人身份信息（PII）被无意捕获。

技术细节

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

相关链接

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