OpenClaw Memory Qdrant

🧠 本地语义记忆,零 API 密钥

为 OpenClaw 智能体提供本地化语义记忆能力,基于 Qdrant 向量数据库和 Transformers.js 嵌入,零配置、无需 API 密钥,支持跨对话上下文记忆与检索。

收藏
28.3k
安装
7.3k
版本
1.0.4
CLS 安全性认证2026-05-21
点击查看完整报告 >

使用说明

核心用法

memory-qdrant 是专为 OpenClaw 设计的本地语义记忆插件,通过三大工具实现记忆管理:

  • memory_store: 存储信息片段(支持分类标签)
  • memory_search: 语义检索相关记忆
  • memory_forget: 按 ID 或查询条件删除记忆

插件采用零配置设计,默认以内存模式运行,重启后数据自动清除;也可对接外部 Qdrant 服务器实现持久化。

显著优点

1. 完全本地化: 基于 Transformers.js 和 Xenova/all-MiniLM-L6-v2 模型生成嵌入,无需 OpenAI/Claude 等外部 API
2. 零依赖成本: 无 API 密钥、无按量计费,首次运行自动下载约 25MB 模型

3. 隐私优先设计: autoCapture 默认关闭,避免意外记录敏感对话;内存模式确保会话隔离

4. 语义理解: 基于向量相似度而非关键词匹配,能理解"workflow preferences"与"task automation habits"的语义关联

5. OpenClaw 原生集成: 遵循官方插件规范,支持配置化启用与工具级调用

潜在缺点与局限性

  • 记忆非持久化: 默认内存模式重启即失,需自行搭建 Qdrant 服务才能持久化
  • 模型能力边界: all-MiniLM-L6-v2 为轻量级模型(22M 参数),复杂语义关联或跨语言场景精度有限
  • autoCapture 隐私风险: 启用后触发正则会捕获邮箱、电话号码等 PII,需用户显式授权
  • 网络依赖: 首次使用需从 Hugging Face 下载模型,离线环境需预置
  • 单节点架构: 无分布式或跨设备同步能力

适合人群

  • 注重隐私、拒绝云服务的 OpenClaw 用户
  • 需要低成本长期记忆能力的个人开发者
  • 构建本地化 AI 工作流的技术团队
  • 对数据主权敏感的企业内网场景

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 数据泄露 | 低-中 | 内存模式风险低;外接 Qdrant 需确保服务器可信 |
| PII 捕获 | 中 | autoCapture 启用后可能记录邮箱、电话,默认关闭 |
| 模型供应链 | 低 | 依赖 Hugging Face 模型下载,建议校验 SHA256 |
| 记忆幻觉 | 中 | 语义检索可能返回低相似度无关记忆,需设置阈值 |

安全解读

核心用法

memory-qdrant 是专为 OpenClaw 设计的本地语义记忆系统,让 AI 代理具备跨对话记忆能力。提供三个核心工具:

  • memory_store:存储结构化记忆片段,支持分类标签
  • memory_search:基于语义相似度召回相关记忆,非关键词匹配
  • memory_forget:按ID或语义查询删除特定记忆

技术架构采用 Qdrant 向量数据库(内存模式零配置,或连接持久化服务)+ Transformers.js 本地嵌入模型(Xenova/all-MiniLM-L6-v2),完全离线运行,无需 API Key。

显著优点

1. 完全本地化:嵌入模型在本地运行,数据不上传云端,隐私可控
2. 零配置开箱即用:默认内存模式无需任何数据库部署

3. 语义理解:基于向量相似度的语义搜索,比传统关键词匹配更智能

4. 灵活集成:可选自动捕获对话上下文(opt-in),自动注入相关记忆

5. 轻量高效:25MB 模型,542行代码,资源占用低

潜在局限

  • autoCapture 隐私风险:启用后会自动捕获邮箱、电话等 PII 信息,需用户明确知情
  • 无数据过期机制:记忆永久保留,缺乏自动清理策略
  • 模型首次下载依赖网络:需从 Hugging Face 下载模型,首次使用需联网
  • 外部 Qdrant 信任假设:若配置远程服务器,数据安全取决于该服务器可信度

适合人群

  • 重视隐私、希望数据完全本地的 OpenClaw 用户
  • 需要 AI 代理具备长期记忆能力的开发者
  • 对 API 调用成本敏感、倾向离线方案的团队

常规风险

  • PII 泄露:autoCapture 功能若误启用,可能记录敏感信息
  • 向量数据外泄:配置外部 Qdrant 时,需确保服务端可信
  • 依赖维护:需关注 @xenova/transformers 等依赖的安全更新

OpenClaw Memory Qdrant 内容

手动下载zip · 14.1 kB
CHANGELOG.mdtext/markdown
请选择文件