ChromaDB长期记忆

技能简介

该技能为AI代理提供基于ChromaDB的长期记忆能力，使用本地Ollama嵌入模型生成向量，无需调用云端API。每次对话前自动注入相关历史记忆，支持手动检索与混合搜索模式。

业务背景

让AI代理拥有'记性'，告别每次对话从零开始。基于本地ChromaDB自动保存对话历史，下一轮交流前智能召回相关背景，无需人工重复交代上下文。全程本地化运行，数据不出境，既保护隐私又节省云端API成本。

落地案例：客服场景：客户上周反馈过订单异常，今日再次咨询时，AI自动调取该历史记录，直接延续处理进度，客户无需复述问题。支持手动搜索过往工单，混合匹配关键词与语义相似度，快速定位同类客诉方案。

能做什么

• 自动召回：每轮对话前将相关记忆注入代理上下文
• 手动检索：通过chromadb_search工具执行显式查询
• 名称解析：通过集合名称自动解析UUID，重建索引后仍可正常工作
• 故障自愈：缓存的集合ID失效时自动重新解析
• 混合搜索：向量相似度结合关键词匹配，提升专有名词召回率

使用说明

安装要求

• ChromaDB v2服务器（本地或远程）
• Ollama服务，需预装nomic-embed-text或其他嵌入模型
• 已在ChromaDB中建立索引的集合

配置步骤

1. 将插件文件部署至技能目录
2. 在配置文件中添加collectionName字段（默认：longterm_memory），collectionId字段不再需要
3. 填写ChromaDB与Ollama的服务地址及嵌入模型名称
4. 启用autoRecall以开启自动记忆注入

配置示例

{"chromadb-memory":{"enabled":true,"config":{"chromaUrl":"http://localhost:8100","collectionName":"longterm_memory","ollamaUrl":"http://localhost:11434","embeddingModel":"nomic-embed-text","autoRecall":true,"autoRecallResults":3,"minScore":0.5}}}

输入与输出

见下方输入与输出表格。

风险提示

• v1.0.0版本存在静默失败缺陷：硬编码UUID在集合重建后失效，导致记忆功能停止且无报错
• 必须升级至v1.1.1+以获得错误提示能力，避免记忆丢失未察觉
• ChromaDB服务不可达时，代理将收到警告信息而非静默跳过
• 混合搜索的关键词提取依赖大小写与引号，全小写查询可能降低专有名词召回效果

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/msensintaffar/chromadb-memory/SKILL.md
来源类型：GitHub仓库