memory-qdrant

memory-qdrant

适用场景： 你需要 OpenClaw Agent 借助语义搜索，在不同对话间记住并回想信息。

⚠️ 隐私声明：可选的 autoCapture 功能默认禁用；如果启用 allowPIICapture，它可能会捕获电子邮件地址和电话号码等个人身份信息（PII）。只有在了解相关隐私影响后才启用。

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

功能

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

安装

clawhub install memory-qdrant

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

配置

在 OpenClaw 配置中启用：

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

选项：

• persistToDisk（默认：true）- 在内存模式下将记忆保存到磁盘。数据存储在 ~/.openclaw-memory/，重启后仍会保留。设为 false 可使用易失性记忆。
• storagePath（可选）- 自定义存储目录。留空则使用默认路径 ~/.openclaw-memory/。
• autoCapture（默认：false）- 自动记录对话。默认启用隐私保护：自动跳过包含 PII（电子邮件地址、电话号码）的文本。
• allowPIICapture（默认：false）- 在启用 autoCapture 时允许捕获 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" })
// or
memory_forget({ query: "text to forget" })

隐私与安全

• 磁盘持久化（默认）：记忆保存到 ~/.openclaw-memory/，重启后仍会保留。设为 persistToDisk: false 可使用易失性记忆。
• 内存模式：当 persistToDisk: false 时，重启会清除数据
• Qdrant 模式：数据会发送到已配置的服务（仅使用可信服务）
• 网络：首次运行时会从 Hugging Face 下载约 25MB 的模型
• PII 保护：默认情况下，autoCapture 会跳过包含电子邮件地址或电话号码的文本。只有在了解相关隐私影响后，才设置 allowPIICapture: true。
• autoCapture：出于隐私考虑，默认禁用。启用后，只会捕获与语义触发条件（偏好、决策、事实）匹配的文本，除非明确允许，否则会跳过 PII。

技术详情

• 向量数据库：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