核心用法
memory-qdrant 是专为 OpenClaw 设计的本地语义记忆系统,通过 memory_store、memory_search、memory_forget 三个工具实现对话信息的持久化存储与智能检索。安装后默认启用 in-memory 模式(零配置),首次运行会从 Hugging Face 自动下载约 25MB 的 Xenova/all-MiniLM-L6-v2 嵌入模型。
显著优点
- 完全本地化:不依赖任何外部 API,数据隐私可控
- 灵活部署:支持 in-memory 快速测试与 Qdrant 服务端持久化两种模式
- 语义检索:基于 Transformer 嵌入向量实现语义相似度搜索,优于关键词匹配
- 零配置启动:开箱即用,适合快速原型验证
潜在局限
- 首次模型下载需网络连接(约 25MB)
- in-memory 模式数据随进程重启丢失
- 依赖原生模块(sharp、onnxruntime),部分环境需额外构建工具
- autoCapture 功能若启用,正则匹配可能误捕获邮箱、电话等 PII 信息
适合人群
需要为 AI Agent 添加长期记忆能力的开发者,尤其适合注重数据隐私、希望避免云 API 依赖的本地化场景。
常规风险
- 外接 Qdrant 服务器时存在数据传输安全风险,需确保服务端可信
- autoCapture 隐私泄露风险(默认关闭)
- 模型下载来源为 Hugging Face,需信任该分发渠道