关于 OpenMem
OpenMem 为编码 Agent 提供统一的记忆 API,可连接 Hindsight、mem0 或 Cognee 等可插拔提供方。共享向导、索引器和 PMM 导入导出格式支持配置与迁移。
主要功能
- 01统一的 `memory_*` 接口
- 02可插拔记忆提供方
- 03共享设置向导和索引器
- 04通过 PMM 导入和导出记忆
- 05用于管理提供方的命令行命令
适用场景
- 01让编码 Agent 使用项目记忆
- 02切换记忆提供方并单独管理内容
- 03导入或导出可移植记忆
MCP 相关
OpenMem 运行 MCP 服务,向编码 Agent 提供统一的 `memory_*` 接口。文档还提及可选的原生或 NotebookLM 服务。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
OpenMem
OpenMem 是面向编码 Agent 的记忆接口:通过可插拔的记忆提供方提供稳定的 memory_* API,并配备通用向导、索引器和导入/导出格式(优先支持 PMM)。
文档: bcmyguest.github.io/openmem/
MCP: npx -y -p @bcmyguest/openmem openmem-mcp
快速入门
| 步骤 | 命令 |
|---|---|
| 1. 向导 | npx @bcmyguest/openmem |
| 2. 检查 | npx @bcmyguest/openmem doctor |
| 3. 编码 Agent | npx @bcmyguest/openmem install-coding-agent --yes |
改为检出仓库,而非使用 npx:
git clone https://github.com/bcmyguest/openmem.git && cd openmem
npm install && npx . setup
需要: Docker Compose v2、Node ≥ 20.12,以及使用 Hindsight 时所需的 LLM 路由(lemond、Ollama 或兼容 OpenAI 的服务——在向导中设置)。
之后:npx @bcmyguest/openmem up / down / switch <provider> --yes / doctor。
向导试运行(展示首次设置计划,不会写入任何内容):

架构
flowchart LR
S[Git repos · notes · feeds] --> I[OpenMem indexer]
I --> P[(One active memory provider)]
A[Coding agents] <--> M["OpenMem MCP · memory_*"]
M <--> P
索引器和编码 Agent 共用一个当前启用的记忆提供方。会话钩子使用相同的 memory_* MCP。设置方法、可选集成及特定提供方的行为,请参阅完整架构说明。
提供方与可移植性
- 提供方 — 提供方状态列出了各清单中的所有提供方及其支持级别。贡献者详情:添加提供方。
- MCP — 统一的
memory_*,以及可选的原生/NotebookLM 服务:MCP 设置。 - 可移植记忆 —
memory_export/memory_import使用 PMM:可移植记忆。 - 切换 —
npx @bcmyguest/openmem switch <provider>本身不会迁移数据;通过导出/导入(或重新索引)来迁移内容。
默认的 Hindsight compose 包含:litellm、hindsight(127.0.0.1:8888)、indexer。除非另行添加,否则 mem0/Cognee 技术栈不包含 LiteLLM。
灵感与相关项目
OpenMem 与这些项目没有关联;它们为该问题或模式提供了启发。
| OpenFeature | 为供应商无关的接口和可插拔提供方提供灵感(该项目用于功能标志;本项目用于编码 Agent 记忆)。 |
| mise / asdf | 通过一个 CLI 使用多种后端;提供声明式配置和任务,同时保留各工具自身的设置。 |
| LiteLLM | 用于 Hindsight 技术栈的模型代理。 |
更多类似的设置方案:可插拔记忆提供方。
项目以前名为 personal-memory。请使用
openmemCLI 和 MCP 服务名称;安装程序会移除旧的personal-memoryMCP 条目。
License
Apache License 2.0 — see LICENSE (Copyright 2026 B Guest).
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。