核心功能
memory-qdrant 是专为 OpenClaw 框架设计的本地语义记忆插件,使 AI 代理具备长期记忆能力。通过三种工具——memory_store(存储)、memory_search(检索)、memory_forget(删除)——实现对话上下文的持久化管理。
显著优点
- 完全本地化:基于 Transformers.js 和 Qdrant 内存模式,无需 API 密钥或外部服务,隐私可控
- 语义检索:使用 all-MiniLM-L6-v2 模型生成 384 维嵌入向量,支持语义相似度搜索而非简单关键词匹配
- 灵活部署:默认零配置内存模式(重启清空),可选外接 Qdrant 服务器实现持久化
- 低门槛集成:自动捕获和上下文注入可配置,适配不同隐私需求场景
局限性与风险
- 存储限制:内存模式数据易失,大规模记忆需外接 Qdrant 服务器,增加运维复杂度
- 首次冷启动:需从 Hugging Face 下载约 25MB 模型文件,网络不稳定时体验受限
- 检索准确性:依赖嵌入模型质量,专业领域术语或复杂推理链可能出现语义漂移
- 安全风险:外接 Qdrant 模式时数据离开本地,需确保服务器可信;
autoCapture若误启用可能导致敏感信息记录
适合人群
- 注重数据隐私、希望 AI 代理具备上下文连续性的开发者
- 构建本地优先 LLM 工作流的技术团队
- 需要快速原型验证记忆能力的 OpenClaw 用户
安全评估
来源为社区开发者(zuiho-kai),代码开源可审计,但缺乏企业级安全认证。建议生产环境外接 Qdrant 时使用 TLS 加密连接。