Chromadb Memory Pub

核心用法

ChromaDB Memory 是一款面向 AI Agent 的长期语义记忆插件，通过本地 ChromaDB 向量数据库与 Ollama 嵌入模型实现上下文持久化。其核心工作流程为：用户每条消息自动经 Ollama（默认 nomic-embed-text）生成 768 维向量 → 检索 ChromaDB 中相似度高于阈值（默认 0.5）的记忆 → 将前 3 条结果注入当前对话上下文。此外提供 chromadb_search 工具支持手动检索。

部署需三步：启动 ChromaDB Docker 容器（端口 8100）、Ollama 服务（端口 11434）并拉取嵌入模型、配置 OpenClaw 插件参数（集合 ID/名称、服务端点等）。支持通过 collectionName 或 collectionId 指定目标集合。

显著优点

• 完全离线：零调用 OpenAI/Claude 等云端 API，数据不出本地，满足敏感场景合规要求
• 自动无缝：无需用户手动触发，每轮对话自动完成嵌入-检索-注入，体验无感
• 成本极低：单次召回约 275 token，对 200K+ 上下文窗口模型可忽略
• 高度可调：相似度阈值、返回数量、自动/手动模式均可灵活配置

潜在局限

• 基础设施负担：需自行维护 ChromaDB + Ollama 双服务，对非技术用户门槛较高
• 召回质量依赖嵌入模型：nomic-embed-text 虽轻量但语义理解弱于商业大模型，可能出现语义漂移
• 无记忆管理功能：缺少遗忘、编辑、冲突解决等高级记忆治理机制
• 冷启动问题：空集合时无记忆可用，需额外文档索引流程

适合人群

• 隐私优先场景（医疗、法律、金融本地部署）
• 已有 ChromaDB/Ollama 技术栈的团队
• 希望降低长期记忆 API 成本的自托管用户

常规风险

• 服务可用性：ChromaDB/Ollama 任一服务宕机将导致记忆功能失效，需监控与备份
• 数据持久化：默认 Docker 部署未配置数据卷，容器重建可能丢失记忆
• 相似度阈值误设：过高导致上下文缺失，过低引入噪声，需根据业务调优
• 模型一致性风险：若更换嵌入模型，历史记忆需重新索引，否则向量空间不匹配

核心用法

ChromaDB Memory 是一款面向 OpenClaw 框架的长期记忆插件，通过 ChromaDB 向量数据库和 Ollama 本地嵌入模型实现完全离线的语义记忆能力。用户在每轮对话前，插件自动将当前消息向量化，查询 ChromaDB 中的相似记忆片段，并将相关上下文注入到 Agent 的 prompt 中。同时提供 chromadb_search 工具支持手动检索。

显著优点

极致隐私保护：全流程本地化——Ollama 运行嵌入模型（nomic-embed-text），ChromaDB 存储向量数据，无需任何云 API 密钥，敏感数据完全不出本地环境，符合 GDPR 本地处理原则。

开箱即用的 Auto-Recall：无需手动管理记忆，每轮对话自动召回最相关的 3 条记忆（可配置），最低相似度阈值过滤噪音，大幅降低使用门槛。

极低资源占用：单次召回约增加 275 tokens，在 200K+ 上下文窗口模型中几乎可以忽略；依赖仅需 curl 和本地运行的两个服务。

灵活可调控：支持 minScore（0.5 默认）调节召回精度，autoRecallResults 控制数量，或完全关闭自动召回改用纯手动模式。

潜在缺点与局限性

部署复杂度：需用户自行维护 ChromaDB（Docker 推荐）和 Ollama 两个本地服务，对非技术用户有一定门槛；索引数据需单独准备，无法直接使用。

来源可信度：T3 级别个人开发者项目（matts），长期维护能力和安全响应速度存疑，生产环境建议 Fork 后自行维护或密切跟踪更新。

功能边界：纯检索式记忆，无记忆总结、压缩或遗忘机制，长期累积可能导致上下文膨胀；仅支持单集合（collection），复杂多用户场景需自行设计隔离方案。

网络假设风险：默认 HTTP 通信 localhost，若误配置为可外部访问的地址则存在暴露风险；无内置 HTTPS 支持和请求超时保护。

适合人群

• 隐私敏感型用户：医疗、法律、金融等场景，数据严禁出境
• 本地 AI 爱好者：已搭建 Ollama + ChromaDB 生态的技术用户
• 离线环境部署：无稳定外网连接或合规要求内网运行
• 成本敏感用户：零 API 调用费用，适合高频长对话场景

常规风险

• 配置风险：collectionId 配置错误导致记忆无法召回
• 服务依赖：ChromaDB 或 Ollama 未启动时插件失效
• 记忆污染：低 minScore 可能引入无关上下文干扰回复质量
• 数据持久化：ChromaDB 数据需自行备份，无自动快照机制