一个插件打通所有 Agent:mem9 多平台集成全清单(Claude Code / OpenCode / Codex / Dify 一次讲透)
一个插件打通所有 Agent:mem9 多平台集成全清单(Claude Code / OpenCode / Codex / Dify 一次讲透)
如果你的 AI Agent 每次会话结束就"失忆",mem9 就是为它准备的持久记忆插件:一套服务、一个记忆空间,就能同时接入 Claude Code、OpenCode、Codex、Dify 等多个 Agent 平台。不同平台装的是各自的"薄插件",但记忆存在同一个 mem9 服务里——在 Claude Code 里存下的事实,OpenCode 和 Dify 工作流也能召回,实现真正的跨平台共享记忆(shared memory)。本文是一份完整的 mem9 多平台集成清单,帮你一次搞懂每个平台怎么装、装完能干什么。
为什么"一个插件"就够了:mem9 的共享记忆架构
很多团队会踩这样的坑:给每个 Agent 各配一套本地笔记和提示词文件,结果 Claude Code 不知道 Codex 查过什么,Dify 工作流更无法参与共享。mem9 的做法是把记忆抽成一个独立的云服务/自建服务:
- 服务端负责一切重活:存储、检索、写入(ingest)、智能事实抽取都放在 mem9 服务端(
mnemo-server),各平台插件只做"薄客户端"; - 所有平台走同一套 API:store、search、get、update、delete 五个核心操作,任何平台的行为都收敛到 server/ 提供的 REST API;
- Agent ID 区分来源:每次请求带
X-Mnemo-Agent-Id头(如claude-code、deepseek-harness),服务端能区分是谁在写入和召回,但召回时不限制来源——这正是"跨 Agent 共享"的关键; - 自带可视化 Dashboard:mem9 提供了把记忆"种"成农场形象的可视化页面,方便检查和管理每条记忆。
各平台集成的形态可以对照这份清单:
| 平台 | 集成形态 | 说明 |
|---|---|---|
| Claude Code | 市场插件 + Hooks + Skills | 会话钩子自动召回/写入 |
| Codex | 市场插件 + 托管 Hooks | 支持全局/项目双作用域 |
| OpenCode | 插件 SDK(server + TUI 双入口) | 全局安装 + 项目级覆盖 |
| Dify | 工具插件(Agent/Workflow 应用) | 单空间与多空间授权 |
| OpenClaw / Hermes / DeepSeek Harness | 各自的记忆插件 | 同样指向同一个服务 |
| 任意 HTTP 客户端 | 直接调 REST API | 自定义运行时也能接入 |
也就是说:不管你用几个 Agent,只需要一份 mem9 API Key 和一个记忆空间。
Claude Code 集成指南:四条 Hooks 全自动运转
Claude Code 插件(claude-plugin/)是安装成本最低的一个:两条命令装完,重启会话后自动初始化。
claude plugin marketplace add mem9-ai/mem9
claude plugin install mem9@mem9
装好后,插件通过 4 条 Hooks 形成完整闭环(详见 claude-plugin/README.md):
| Hook 时机 | mem9 做什么 |
|---|---|
SessionStart(startup) |
自动初始化,缺失时自动创建 API Key 缓存 auth.json |
UserPromptSubmit |
用你的提问召回相关记忆,注入 <relevant-memories> 块 |
Stop |
把最近一轮 user/assistant 对话上传做智能写入 |
PreCompact |
上下文压缩前上传更大的最近窗口,防止记忆丢失 |
另外还暴露了 3 个 Skill 命令,方便手动操作:
/mem9:setup— 自动初始化没跑成功时的补救入口/mem9:recall— 手动召回/mem9:store— 手动存储
🛡️ 设计上召回和写入都是 best-effort:即使 mem9 服务暂时不可达,Claude Code 也会照常工作,不会被插件卡死。
Codex 集成:一个空间,多套 Profile
Codex 插件(codex-plugin/)同样走市场安装,然后运行 $mem9:setup 引导完成配置:
codex plugin marketplace add mem9-ai/mem9
在 Codex 里执行 /plugins 找到 mem9 安装,再运行 $mem9:setup 即可。它的能力比 Claude Code 插件更"多租户":
- 多 Profile 管理:可以在
~/.mem9/.credentials.json里保存default、work等多个记忆空间档案,个人空间和项目空间互不污染; - 双作用域:
user scope全局生效,project scope只覆盖当前仓库,还能按仓库单独调searchTimeoutMs、recallMinPromptLength等参数; - 4 个 Skill 命令:
$mem9:setup(主入口)、$mem9:cleanup(清理托管文件)、$mem9:recall、$mem9:store; - 托管 Hooks 自动修复:
$mem9:setup会自动启用 Codex hooks 特性并修复$CODEX_HOME/hooks.json,不需要手动配置钩子。
行为上,Codex 插件在每条用户消息前自动召回相关记忆,在 Codex 停止时自动保存最近的对话窗口——和 Claude Code 是完全对称的体验。
OpenCode 集成:全局一次安装 + 项目级覆盖
OpenCode 插件(opencode-plugin/)有 server 和 TUI 两个入口,推荐"全局装一次 + 项目按需覆盖":
opencode plugin --global @mem9/opencode
重启后运行 /mem9-setup,它会处理共享凭证和 OpenCode 侧配置两件事,支持"自动获取 API Key"或"填入已有 Key"。项目级覆盖写在 <project>/.opencode/mem9.json,可以单独指定 profile、debug 开关和超时参数。
运行时它通过 4 个钩子工作(详见 opencode-plugin/README.md):
chat.message— 捕获最新用户输入;experimental.chat.system.transform— 搜索 mem9 并注入<relevant-memories>块;session.idle— 会话空闲时后台智能写入;experimental.session.compacting— 压缩时追加一次写入机会。
同时注册了 5 个模型可用的工具:memory_store、memory_search、memory_get、memory_update、memory_delete——Agent 可以像调函数一样主动管理记忆,而不只是依赖自动流程。
Dify 集成:让工作流应用也用上同一份记忆
Dify 的集成走独立工具插件(mem9-dify-plugin),面向 Dify 的 Agent 应用和 Workflow 应用,提供记忆工具,并支持单空间与多空间授权两种模式——适合"一个 Dify 工作流服务多个记忆空间"的场景。
这里最能体现 mem9 的价值:Dify 里构建的客服工作流,和你在 Claude Code 里调试代码时存下的项目事实,可以指向同一个 mem9 空间。工作流召回到的上下文,就是你所有 Agent 共同沉淀下来的记忆。
快速上手:托管 API vs 自建服务端
所有平台的插件只依赖两个环境变量:
export MEM9_API_URL="https://api.mem9.ai"
export MEM9_API_KEY="<mem9-api-key>"
- 托管 API:零基础设施,Space 即时开通,开箱即用的混合检索(语义 + 关键词),底层跑在 TiDB Cloud Starter 上;
- 自建服务端:
mnemo-server是 Go 写的 REST 服务(server/),支持tidb、postgres、db9三种后端,应用对应控制面 schema(如 server/schema.sql)后启动即可; - 迁移无痛:托管和自建的 API 契约完全一致,从托管切换到自建只是改 base URL 和凭证,不用改任何插件代码。
想验证服务是否正常,可以调 GET /v1alpha2/status 校验 API Key 状态;端到端脚本可参考 e2e/api-smoke-test.sh。
常见疑问 FAQ
Q1:多个平台同时写同一个空间会冲突吗?
不会。每次请求都带 X-Mnemo-Agent-Id 标识来源,写入按 agent_id 归桶;而召回是跨桶的,这正是"共享记忆"的设计意图。
Q2:某个平台召回失败会影响 Agent 工作吗? 不会。所有插件都把召回/写入当作 best-effort 处理,mem9 不可用时 Agent 照常对话。
Q3:怎么检查记忆都存了什么? 用 mem9 的可视化 Dashboard(dashboard/),记忆会以"记忆农场"的形式呈现,可以直接检查和导出。
Q4:只想用一个平台,其他配置还需要吗? 不需要。每个平台插件独立可用,共享只是"用同一个 Space"这一件事,其余各自安装互不干扰。
总结:一份记忆空间,N 个 Agent 平台
mem9 的多平台集成逻辑可以概括为一句话:插件薄、服务厚、空间共享。Claude Code、Codex、OpenCode 各有贴合自身运行时形态的插件与命令,Dify 则通过工具插件把工作流纳入同一记忆网络;而真正的存储、检索与智能抽取全部收敛在 mem9 服务端。选一个平台装好试试,再给第二个平台配上同一个 API Key——你就会看到跨 Agent 共享记忆的效果。
- 想自己调 API 验证流程?用独立的 cli/ 命令行工具
- 服务端 API 契约细节见 docs/api/openapi.json
- 检索算法原理可阅读 docs/architecture/mem9-algorithms/recall.zh-CN.md

