核心用法
ChromaDB Memory 是一个为 OpenClaw 设计的长期记忆插件,通过本地 ChromaDB 向量数据库和 Ollama 嵌入模型实现语义记忆功能。其核心工作流程为:用户发送消息 → Ollama(nomic-embed-text,768维)生成向量嵌入 → ChromaDB 执行最近邻搜索 → 将高于阈值的结果自动注入代理上下文 → 代理基于增强上下文响应。
主要配置项包括:ChromaDB 服务端点、集合ID/名称、Ollama 地址、嵌入模型选择,以及三个关键调参选项——autoRecall(开关自动召回)、autoRecallResults(每轮最大召回数,默认3条)、minScore(相似度阈值,默认0.5)。插件同时提供 chromadb_search 工具供手动语义检索。
显著优点
1. 完全本地化:零云依赖,数据不出本地硬件,契合隐私敏感场景
2. 自动上下文增强:每轮对话前静默注入相关记忆,降低用户操作负担
3. 成本可控:每轮约275 tokens(最坏情况),在200K+上下文窗口中可忽略
4. 生态兼容:标准 ChromaDB 接口,支持任意兼容索引器填充数据
潜在缺点与局限性
- 基础设施依赖:需自行维护 ChromaDB 和 Ollama 服务,增加部署复杂度
- 调参门槛:
minScore和autoRecallResults需根据数据分布反复调试,过高漏召回、过低引噪声 - 无内置持久化策略:未提及记忆过期、冲突消解、用户隔离等高级管理功能
- 单集合架构:当前配置仅支持单一集合,多用户/多场景隔离需自行设计
适合人群
注重数据主权的技术型用户、企业内部部署场景、已运行 Ollama 生态的本地 AI 实践者。
常规风险
配置中的集合ID若泄露可能导致向量数据被遍历;ChromaDB 默认无认证,生产环境需额外网络隔离;Ollama 模型拉取需验证来源完整性。