01WHAT IT SOLVES
这个项目解决什么问题?
Mem0 是面向 AI 代理的通用记忆中间层,作为 RAG 与向量检索之上的状态管理层出现。它通过单次抽取将对话事实存入向量库,并结合语义、BM25 关键词与实体匹配做多路召回与时间感知排序,支撑用户、会话与代理三级记忆。在同类方案中,它定位偏生产化基础设施,同时提供本地库、自托管 Docker 与零运维云平台三条路径,开源 SDK 与托管服务在能力上存在差异,适合对长期记忆与一致性有较高要求、又希望沿用主流 LLM 与向量栈的团队。
02CORE CAPABILITIES
核心能力
多级记忆管理
同时维护用户、会话与代理三级状态,支持自适应个性化与跨会话延续
多路召回与时序重排
融合语义向量、BM25 关键词与实体匹配,并加入时间感知排序提升时序正确性
灵活部署形态
同时提供 pip 与 npm 库、Docker 自托管与托管云平台,覆盖原型到生产场景
框架与代理集成
内置 LangGraph、CrewAI、ChatGPT 等集成路径与浏览器扩展,便于嵌入既有代理栈
03适合谁
- 构建 AI 代理或对话应用的工程师
- 关注用户体验与长期个性化的产品团队
- 需要自托管或私有部署 LLM 应用的平台与运维工程师
- 使用 LangGraph、CrewAI 等代理框架的集成开发者
04典型使用场景
- 客服机器人跨会话调取用户历史工单与偏好
- AI 助手在不同设备间延续用户的写作风格与任务上下文
- 健康类应用追踪患者长期偏好与历史,提供个性化建议
- 生产力工具或游戏根据用户行为自适应调整工作流与环境
05为什么值得关注
- 2026 年 4 月新算法在 LoCoMo 与 LongMemEval 上较上一版提升 20 分以上
- 提供从自托管到托管平台的端到端路径,并面向 AI 代理开放免邮箱注册
- 维护活跃,Python 与 Node SDK 近两周内均有多次修复与功能更新
- 已开源评估框架,便于社区复现基准结果
06采用前要注意
- 开源 SDK 与托管平台在能力上存在差异,部分高级特性仅托管可用
- 默认依赖 OpenAI 模型与嵌入,私有部署需自行接入并调优嵌入模型
- 接入涉及记忆抽取策略、向量库与 LLM 配置,初次集成成本较高
- 官方基准数据来自托管平台专有优化,开源版本只能获得方向相似的提升
07RELEASE INTELLIGENCE
近期版本变化
Mem0 ts-v3.3.1:修正非 OpenAI 供应商默认配置污染
Node SDK 修复 ConfigManager 在 DeepSeek、xAI 等非 OpenAI 供应商配置上误注入 OpenAI 默认 baseURL 与 model 的问题;为 Turbopuffer 补齐 eq、ne、in、nin 等比较运算符;修正 euclidean_squared 距离映射导致排序倒置的缺陷;将 pg、natural 等改为可选 peer 依赖并放宽版本范围,避免与业务项目冲突。影响使用非 OpenAI 模型或 Turbopuffer 的 Node 集成开发者,建议升级。
- 非 OpenAI 供应商不再被 OpenAI 默认配置覆盖
- Turbopuffer 支持全部比较运算符与距离计分
- pg 等依赖改为可选 peer 依赖并放宽版本范围
Mem0 v2.2.1:修复 add 误报与多家向量库评分异常
Python SDK 的小版本维护,修复 Memory.add 把向量库拒绝的记录错误标记为成功的问题,并在无记录可插时抛出 VectorStoreError;恢复 Memory 与 AsyncMemory 的上下文管理器协议;修正 AWS Bedrock Claude 推理模型首个文本块读取错误;为 Turbopuffer 与 S3 Vectors 补齐全部比较运算符与距离计分映射。影响正在使用 Bedrock、Turbopuffer 或 S3 Vectors 存储的生产用户,需要升级以避免静默丢数据与错误排序。
- 修正 add() 把向量库拒绝记录写入历史的逻辑
- 恢复 Memory 与 AsyncMemory 的上下文管理器协议
- Bedrock Claude 推理模型首个文本块读取修复
- Turbopuffer 与 S3 Vectors 算子与评分映射补齐
Mem0 pi-agent-v0.3.2:精简搜索提示以减少冗余检索
Pi Agent 插件调整内存策略与工具描述,不再要求代理对每条问题都先做记忆检索,而是仅在需要复用此前的决策、修复或命令时再调用;context-loader 从并行多次搜索收敛为单次搜索;自动注入记忆的措辞与其他插件统一,并去除所谓“浅层首轮”提示。影响使用 Claude Code、Codex、Cursor 等代理的开发者,可观察 token 消耗与响应时延变化。
- 搜索提示改为按需触发,减少冗余检索
- context-loader 收敛为单次搜索
- 自动注入记忆的提示措辞与其他插件统一
Mem0 openclaw-v1.2.1:检索提示措辞统一
Mem0 OpenClaw 插件的 memory_search 工具描述改为与同类编码代理插件一致:不再要求代理主动检索或多问题多次检索,仅在重复调查或需要参考过往决策、修复、命令、结果时执行检索;smart、always、manual 三种召回策略行为保持不变。影响 OpenClaw 插件用户,检索行为更可控且与其他插件一致。
- 工具描述措辞与其他编码代理插件对齐
- smart、always、manual 三种召回策略行为未变更
- 官方说明未提供更多细节
Mem0 opencode-v0.4.1:检索提示与技能调用收敛
Mem0 OpenCode 插件的 search_memories 工具描述不再要求代理对多部分问题主动或多次检索,仅在重复调查或需要参考过往决策、修复、命令、结果时调用一次;/mem0-search 与 /mem0-context-loader 技能改为单次 search_memories 调用,并移除要求代理在回复前并行运行 2-4 次检索的两条系统提示。影响 OpenCode 插件用户,可降低 token 与延迟开销。
- 工具描述从主动多次检索改为按需单次
- 移除两条并行检索的系统提示
- 检索技能改用与其他编码代理插件一致的描述
Mem0 ts-v3.3.0:客户端支持异步用户画像生成
Node SDK 同步引入 User Profiles 能力,MemoryClient 暴露 getProfile、generateProfile、getProfileSettings、updateProfileSettings、sampleProfiles 与 getProfileJob 等方法。画像由 JSON Schema 与 LLM 从历史记忆生成,生成任务异步执行并携带 Idempotency-Key,便于在网络抖动时安全重试。适合在 Node 侧构建需要长期用户档案的应用,关注其对现有调用链路的改动。
- 客户端新增 User Profiles 相关方法
- 画像生成异步执行并支持幂等键
Mem0 v2.2.0:新增用户画像结构化摘要能力
Python SDK 在 MemoryClient 与 AsyncMemoryClient 中引入 User Profiles,可通过配置的 JSON Schema 由 LLM 从记忆生成结构化、始终最新的用户画像,并提供生成、查询、设置与采样接口;生成异步执行且支持 Idempotency-Key 安全重试。同时修复 Valkey 存储在 created_at 与 updated_at 为 None 时崩溃的问题。适合需要持续可解析用户档案的应用,需要评估其对成本与延迟的影响。
- 客户端新增结构化用户画像生成与查询接口
- 用户画像生成支持幂等键安全重试
- 修复 Valkey 时间戳为 None 触发的 TypeError
mem0 opencode-v0.4.0:调整遥测标签与安装去重
OpenCode插件的PostHog source标签从字面量"plugin"改为OPENCODE_PLUGIN,并新增对project_hash的加盐处理;依赖source="plugin"过滤PostHog洞察的旧报表将不再匹配新事件,历史数据不受影响。安装计数改为按keyFingerprint去重,每个key只计一次。影响依赖PostHog看板与安装统计的下游使用者。
- PostHog source标签由"plugin"改为OPENCODE_PLUGIN
- project_hash新增加盐处理以保护隐私
- 基于keyFingerprint的安装去重,每个key仅计入一次
mem0 vercel-ai-v3.0.3:同步三层标识Header
Vercel AI SDK Provider继承TypeScript SDK新增的三层表面标识Header,使通过Vercel AI SDK发出的请求能在Mem0平台被正确归属到具体来源产品、宿主应用与调用链。影响使用Vercel AI SDK接入mem0的开发者,对功能调用无破坏性变更。
- 同步继承X-Mem0-Source、X-Application、X-Mem0-Client三组Header
- 与Python SDK和Node SDK保持一致的调用归属策略
- 对Vercel AI SDK用户为非破坏性升级
mem0 pi-agent-v0.3.1:修复遥测重复与丢事件问题
Pi Agent插件修复了事件重复投递与已暂存事件丢失的问题,并让每个事件可正确归属到产生它的插件。wire字段中的plugin_version与本次固定版本号保持一致。受影响由Pi Agent用户上报的问题修复。
- 修复遥测事件重复投递
- 修复已暂存事件丢失
- 事件正确归属到具体插件