memory-qdrant 是一个面向 OpenClaw 智能体的本地语义记忆插件，适用于需要智能体跨对话记住并回忆信息的场景。它由 Qdrant 向量数据库和 Transformers.js 嵌入模型提供支持，主打零配置、完全本地运行，无需 API 密钥或外部服务。
用途 该插件用于为 OpenClaw 智能体提供语义搜索式的记忆能力，使其能够存储、搜索和回忆对话上下文。当需要智能体记住用户偏好、决策或事实并在后续对话中调用时，可以使用此插件。
主要能力
- 使用本地 Transformers.js 嵌入进行语义搜索。
- 支持内存模式（零配置）或持久化的 Qdrant 存储。
- 可选的对话上下文自动捕获（opt-in，默认禁用）。
- 上下文感知的记忆回忆。
- 完全本地运行，不需要 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" }) // 或 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，采用工厂函数模式
适用场景 适用于希望 OpenClaw 智能体在多次对话之间保持语义记忆、且对数据本地化和隐私有要求的用户。
限制
- 首次运行需要下载约 25MB 模型，原生依赖可能需要构建工具。
- autoCapture 默认禁用，且默认跳过 PII。
- 使用外部 Qdrant 服务器时数据会发送到该服务器。
- 关于收费、价格、平台支持范围等信息，资料中暂未提供。