一个插件打通所有 Agent:mem9 多平台集成全清单(Claude Code / OpenCode / Codex / Dify 一次讲透)

原创2026-10-13 21:25:421,828 阅读
文章标签:人工智能Agent 记忆AI 插件dsh-plugin后端前端CLI文档

一个插件打通所有 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 的记忆在同一个共享空间中生长

为什么"一个插件"就够了: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 共同沉淀下来的记忆。

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 共享记忆的效果。

登录后查看全文
mem9