Skip to main content
Nowledge MemNowledge Mem
连接

连接

把你的 AI 工具连接到同一份记忆。自由切换,上下文不变。

Nowledge Mem 的连接入口,是让你真正每天在用的工具共享同一份记忆。知识留在一个地方,工具可以随时更换。

在 Nowledge Cloud 上使用 Team 工作区?Slack 连接指南 介绍安装授权、频道与 Space 绑定,以及已有连接如何更新权限。此托管连接不适用于本地工作区或 Team Lite。

一段提示词,连接任意工具

连接受支持的 AI 工具,最快的办法是一段提示词:

读取 https://mem.nowledge.co/SKILL.md,并按其中说明为我当前使用的 AI 工具安装或更新 Nowledge Mem。

把它粘到 Claude Code、Grok Build、Grok Bot、Codex、Cursor、Gemini CLI、Google Antigravity、Copilot CLI、OpenClaw、Hermes、Droid、Alma、Bub、Craft Agent、Cindy、Pi、Step Code、OpenCode、Amp、Kimi Code、Kimi Work、ZCode、MiMo Code、OMP 或 Claude Desktop 中。AI 工具会读取 SKILL.md、识别所在宿主、选择匹配的安装或设置路径、验证连接,并告诉你需要重启什么。命令行宿主通常可以直接安装;桌面应用型工具可能仍需要你确认市场安装或手动步骤。

如果要远程或跨设备接入,先用 nmem config client set --url ... --api-key ... 配置共享客户端连接。桌面应用里的远程 URL 和 API key 相关设置位于 设置 → Access Anywhere。

下面的页面仍然有用。它们讲清每个工具的行为(Working Memory 怎么接、怎么检索、怎么提炼、怎么保存线程),也包括少数几个要换条路安装的入口(浏览器扩展、Raycast、轨迹提取器)。先从这段提示词开始;需要行为细节或排障时,再翻对应页面。

如果你是新用户

如果你刚装好 Mem,请先看 从这里开始:先保存一条记忆,再把上面的 Connect 提示词粘到你日常用的 AI 工具里。这一页用作每个工具的行为参考。

先理解“自主能力阶梯”

接入的是同一个 Mem 服务器,不同宿主给你的实际体验却可能差很多。

路径Working Memory检索与提炼对话线程
原生连接通常能在会话开始时自动加载,或接进宿主的生命周期能力最强;有的靠 hooks,有的靠引导,也有的是两者混合有些宿主还能做到真实自动捕获或真实 transcript 保存
通用 Agent Plugin通过标准 Agent Plugins skills 引导给没有专属连接的兼容客户端提供 skills + 本地 MCP除非客户端另有 transcript 路径,否则只做 handoff
直接 MCP只有在你补上推荐提示后,才会更主动本质上仍是“有引导”;光有 MCP tools 不会自动变成自治记忆搜索和读取已保存对话;不导入本地 transcript
复用型工作流包通常是“有引导”主要靠 rules、skills、prompts 去教模型主动用大多只能做 handoff,或明确请求时再保存

最实用的规则只有一句:宿主能装专属 Nowledge 路径时,就先装它。通用 Agent Plugin 给“支持 Agent Plugins、但没有专属 Nowledge 连接”的客户端使用;只有在没有更好入口时,才退回到通用 MCP。

不过有一个值得单独说清的例外:有些宿主最好的体验其实是 hybrid。现在最典型的就是 Codex。先装 Codex 插件包,获得自动 Context Bundle / Working Memory、两套记忆的明确路由、自动线程捕获、内置本地 MCP 和 nmem 兜底。如果同时开启 Codex 本地 Memory,请按 Codex 指南 关闭工具辅助任务的记忆生成。如果你使用远程 Mem 或自定义端口,再在 Codex 配置里覆盖这条 MCP 连接。

Nowledge FS 是所有 Agent 共用的入口

Nowledge FS 是共享的路径层。人在应用里看到的是知识树;原生连接、直接 MCP 客户端、脚本和自定义 Agent 则通过 nmem fs、/fs/* 或 mem_fs MCP 工具使用同一套结构。

对话同步到底走哪条路径

Mem 有三条对话同步路径。它们的目标不是各存一份,而是汇入同一条已保存的对话。

路径什么时候运行是否支持远程 Mem适合什么
桌面端自动同步Mem 应用在本机监听受支持工具的 transcript 文件只有 transcript 和 Mem 在同一台机器上才可以同一台机器上的后台捕获
连接器 hooksAI 工具在会话结束、压缩前或每轮之后调用插件支持让新会话持续进入 Mem
历史导入你运行 nmem t sync --from ... 先预览,再导入旧会话支持把过去的本机会话补进 Mem

关键边界是 transcript 在哪里。如果 Mem 跑在另一台机器上,那台服务器无法自己扫描你笔记本上的 ~/.codex、~/.claude、~/.gemini、~/.pi、Kimi Work 运行时或 OpenCode 数据库。请在 AI 工具运行的那台机器上安装连接器或执行 nmem t sync;它会通过同一份 nmem 客户端配置,把结果上传到本地或远程 Mem。

这些路径使用同一套 source 名称和稳定 thread ID。比如 Claude Code 的会话无论来自桌面端 watcher、Claude Code hook,还是一次历史 nmem t sync,都会落到 claude-code-<sessionId>,不会拆成多条重复对话。

如果导入中途停止,直接再运行一次即可。历史同步会先预览、逐个会话处理;重复运行时会走带去重的追加路径,而不是制造重复消息。

先选路径,再开始

Nowledge Mem 的连接方式有很多,但第一判断其实很简单:如果你的工具已经有专属 Nowledge 连接入口,就先用它。只有在没有专属路径时,才考虑共享包、直接 MCP、CLI 或导入流程。

对大多数用户来说,可以按这个顺序判断:

  1. 你的工具如果已经有专属 Nowledge 连接入口,就安装它。
  2. 如果你的工作主要发生在 ChatGPT、Claude、Gemini、Microsoft Copilot 等网页聊天里,就安装浏览器扩展。
  3. 如果客户端支持 Agent Plugins、但还没有专属 Nowledge 连接,就用通用 Agent Plugin。
  4. 如果客户端支持 MCP,就直接配置 MCP,除非已经有更好的包;Codex 这类 hybrid 宿主则按指南同时使用专属包和 MCP。
  5. 如果客户端支持共享技能或提示词、但没有 MCP 工具面,就用复用型工作流包。
  6. 如果你需要手动命令、脚本或本地自动化,就直接使用 CLI。
如果你使用...推荐路径连接类型为什么
Gemini CLIGemini CLI 扩展原生连接专属扩展,内含 MCP、生命周期钩子、命令、技能,并在压缩前或退出时导入真实会话
Google AntigravityGoogle Antigravity 插件原生连接由 abn 贡献的专属插件,提供启动上下文、内置 MCP、skills、lifecycle hooks、离线重试与真实 Antigravity transcript 捕获
Claude CodeClaude Code 插件原生连接专属插件,提供生命周期钩子、斜杠命令、工作记忆简报加载与自动会话捕获
Grok BuildGrok Build 指南原生连接编程智能体插件路径,提供启动上下文、记忆引导,并通过 nmem 自动捕获本机会话
Grok / Grok BotGrok connector 指南远程 MCP 连接同一个公开 OAuth MCP connector 可以在普通 Grok 对话和 Bot 中使用;目前不承诺自动捕获完整会话
Claude 云端Claude 云端指南远程 MCP 连接通过预填的自定义 connector 调用已授权的 Cloud 或 App workspace;对话捕获仍需单独的导出或本地连接器
MiniMax 云端MiniMax 云端状态等待 provider 审批本地 MiniMax Code package 已就绪;MiniMax 确认 provider 和 scope 前,不要配置托管 Cloud App
DroidDroid 插件原生连接Factory 原生连接,提供生命周期钩子、命令、技能,以及基于 nmem 的清晰交接摘要路径
CursorCursor 插件原生连接专属插件包,内含启动时加载 Working Memory 的钩子、MCP 配置、规则、技能,以及明确的交接摘要语义
OpenClawOpenClaw原生连接专属插件,带有工具级生命周期支持、检索与捕获行为
AlmaAlma原生连接专属插件,带有工具级生命周期支持与检索行为
OpenCodeOpenCode 指南原生连接原生连接:Context Bundle、Working Memory、搜索/保存工具、idle 自动会话捕获、压缩前 flush 与交接
AmpAmp 指南原生连接Amp 专属插件:Context Bundle、记忆工具、图谱扩展、命令面板操作,并通过 agent.end 捕获对话
Copilot CLICopilot CLI 指南原生连接专属插件,提供生命周期钩子、Working Memory 启动、检索引导,以及压缩前或退出时的会话捕获
Kimi CodeKimi Code 指南插件 + MCP + hookKimi 会直接从插件 manifest 加载 Mem 和原生 lifecycle hooks;旧会话仍可用 nmem t sync --from kimi-code 补导
Kimi WorkKimi Work 指南MCP + 启动技能 + 导入Kimi Work 使用独立的内置 Kimi Code 运行时。连接器负责启动指引和 MCP;需要导入本机会话时,运行 nmem t sync --from kimi-work。
ZCodeZCode 指南插件 + MCP + hooksZCode 原生插件,内置 MCP、Skills、命令、启动/检索 hooks,并通过 nmem 执行 Stop-hook transcript 捕获
MiMo CodeMiMo Code 指南MCP + 指引 + 导入与 OpenCode 接近;可用 nmem t sync --from mimo-code 导入本机会话,实时 hook 包仍需单独验证
Craft AgentCraft Agent 指南MCP source + guide + 导入Craft workspace source 暴露 Mem 工具,guide 负责行为引导;nmem t sync --from craft-agent 导入本机 Craft session.jsonl transcript
CradleCradle 指南官方内置插件Cradle 自己随应用提供集成,支持引导式 Working Memory、Context Bundle、记忆与 Thread 操作,并可选注册 MCP
ArkloopArkloop 指南原生 Memory providerArkloop 会在回复前加载 Working Memory 与相关召回,持续保存 source=arkloop Thread,并可自动提炼知识
OpticLMOpticLM 指南内置 Thread bridge + 可选 MCPOptic 自己负责 Space 与 Thread 同步;如果 Agent 还需要召回和长期记忆工具,再同时添加标准 Mem MCP
WorkBuddyWorkBuddy 指南插件 + MCP + hook完整插件提供启动上下文、记忆检索和内置 MCP;hook 通过 nmem t capture --from workbuddy 将主 Agent 和 Subagent 的 transcript 入队。nmem t sync --from workbuddy 用于手动导入历史会话。
CodeBuddyCodeBuddy 指南插件 + MCP + hook腾讯 CodeBuddy Code 可使用原生插件:内置 MCP、启动上下文、斜杠命令,并通过 lifecycle hooks 同步本地 .jsonl transcript
OMPOMP 指南原生连接专用 OMP 插件提供启动上下文、自动对话捕获、技能,以及 nmem t sync --from omp 旧会话补导
LangGraphLangGraph 指南Agent 框架连接器身份感知的 Python middleware,临时注入上下文、约束 Mem 工具 scope,并捕获顶层 Thread,不替换 LangGraph checkpoint
没有专属连接的 Agent Plugins 兼容客户端通用 Agent Plugin标准插件包可移植 Agent Plugins 包,包含共享记忆 skills 和本地 MCP。它是兼容客户端的兜底入口,不替代原生连接。
没有专属 Nowledge 包、但支持 MCP 的客户端直接 MCP(见下文)直接 MCP用一套共享 MCP 配置接入标准工具能力
更多支持共享技能的编程智能体npx skills复用型工作流包当客户端没有 MCP 工具面时,用共享 skills 复用记忆工作流
ChatGPT 网页版 / 桌面版ChatGPT 指南Cloud 官方插件 / App 自定义 MCP + 浏览器捕获个人或 Team 工作区在 Nowledge Cloud 时安装官方插件;电脑上的 Mem 另建 Access Anywhere / Nowledge Link 连接。完整聊天捕获用扩展。
DotsDots 指南Cloud 官方插件 / App 自定义 MCP查找已保存的决策、保存选定要点;聊天原文快照需要单独授权。
Chrome 或 Edge浏览器扩展浏览器捕获入口从浏览器侧边栏直接捕获和提炼对话
终端、脚本或远程工作流CLI直接命令入口直接使用 nmem 完成搜索、保存、自动化与受支持的线程导入
CodexCodex 指南原生连接自动启动上下文、两套记忆路由、内置 MCP 与 Stop-hook 线程捕获,桌面端和 CLI 共用
RaftRaft 指南中介式多智能体宿主连接 worker 运行时,并给每个 worker 设置一个 Mem 身份。Raft 内可使用 Mem skills/MCP;托管 Codex 执行轨迹不会写入 Threads。
LodyLody 指南运行时启动器先连接 Lody 启动的 AI 工具;只有当 Agent Config 代表稳定角色时,才添加 NMEM_AGENT_ID
MulticaMultica 指南多智能体编排先连接 Multica 启动的 AI 工具;如果用 Claude Code,把 Mem MCP 保存到 Multica Agent MCP 设置;再把 NMEM_AGENT_ID 添加到 custom env
CumoraCumora 指南多智能体工作区先连接 Cumora 启动的 AI 工具;没有每 Agent env 时,用 persona instruction 传入身份
PaseoPaseo 指南多智能体编排先连接 Paseo 启动的 AI 工具;只有当 Paseo agent 是稳定角色时,才添加 NMEM_AGENT_ID
MirasimMirasim 指南多智能体工作台将 Mem 添加为 Mirasim MCP server 给内置 agent 使用;Mirasim 启动的 Claude Code 或 Codex pane 仍用各自专属连接捕获 transcript
CindyCindy 指南本地 agent host将 Mem 添加为 Cindy MCP server 给内置 agent 使用;真实 transcript 捕获仍用被启动子运行时的专属连接
PiPi 指南原生连接原生包,包含技能和自动 Pi 对话同步
Step CodeStep Code 指南原生连接专用插件包,提供启动上下文、settled-turn 自动同步、技能和原生 JSONL 历史补导
Hermes AgentHermes 指南原生连接原生记忆提供者,提供 Working Memory 启动、每轮前检索,以及干净的 Nowledge 工具名
Ekko AgentEkko 指南MCP + 本地导入Hermes Studio 内置 Ekko Agent 可通过 Mem MCP 使用上下文和工具;nmem t sync --from ekko 会从本地 SQLite 导入真实 Ekko 对话
PromaProma 指南原生连接桌面智能体接入方式:MCP 工具、写入 CLAUDE.md 的启动上下文、自动会话保存和标准 skills
你已有的笔记Obsidian、Notion、Apple Notes本地知识来源在 AI Now 中把笔记与记忆一起搜索
历史会话或导出文件对话指南导入入口把文件、导出记录和过去的会话导入 Mem

大多数用户只需要看表里的一行

找到你已经在用的那个工具,点进去照着那份指南做,先不用把这一整页都读完。

通过 OAuth 远程连接 MCP

当某个 AI 客户端要求填写远程 MCP URL,并通过 OAuth 授权时,先选择宿主:Grok Bot、ChatGPT 和 Claude Cloud 使用公开 /mcp 地址;MiniMax Cloud 在 provider 审批前不可用。Cloud workspace 使用固定 Cloud 地址;App workspace 由 Access Anywhere 提供该用户自己的公开地址。宿主直连所选 workspace,Nowledge 不通过共享网关转发 App 的 MCP 流量。

ChatGPT 用户的个人或 Team 工作区在 Nowledge Cloud 时,直接安装官方插件。Mem 在自己的电脑上时,按App 连接指南设置 Access Anywhere 或 Nowledge Link。自定义连接的创建入口仍受账号的 Developer mode 和工作区策略影响。

使用公开 HTTPS 地址

云端客户端无法访问 localhost 或私有局域网地址。如果你的 Mem workspace 在 Nowledge Cloud 上,请使用公开的 /mcp 地址。如果 Mem 运行在你的电脑上,请先配置带公开 HTTPS 地址的 Access Anywhere。

如果使用 Nowledge Cloud workspace:

  1. 打开连接。
  2. 复制 workspace 的公开 Cloud MCP 地址。它必须以 /mcp?space_protocol=exact-v1 结尾,例如:
https://cloud.nowledge.co/mcp?space_protocol=exact-v1

如果使用本地桌面 Mem,请打开 连接 → 通过 OAuth 远程连接 MCP,点击开始设置,再复制它提供的 Access Anywhere 地址。它必须是公开 HTTPS 地址,并以 /mcp 结尾。

下面是 ChatGPT 自定义连接的步骤,不是官方插件的安装步骤:

  1. 如果账号允许自定义 MCP,打开 ChatGPT Plugins,点击加号,再选择 Add custom MCP server。
  2. 粘贴 Mem MCP endpoint。
  3. 继续完成 ChatGPT 的 connector 设置。
  4. 当 Mem 打开 OAuth 授权页面时,确认授权。
  5. 之后在 ChatGPT 网页版或桌面版里输入 @Nowledge Mem,让 ChatGPT 搜索 Mem。

其他 OAuth MCP 客户端也使用同一个 endpoint。关键是粘贴 Mem 给出的公开 /mcp 地址,不要粘贴普通网页地址,也不要粘贴私有 nmem_ API key。

完整的 ChatGPT 截图步骤请看 ChatGPT 网页版与桌面版。

适合很多编程智能体的最快复用方案

对于支持 skills 安装器的智能体环境:

npx skills add nowledge-co/community/nowledge-mem-npx-skills

这会安装可复用的记忆技能,用于搜索、Working Memory、交接与提炼。智能体仍会自己决定何时调用它们;如果你的工具支持原生连接或 MCP 配置,自动化程度会更高。

Gemini CLI 和 Antigravity 2.0

Gemini 系工具现在从 ~/.gemini/config/skills 读取全局 skills。如果你之前已经连接过 skills,但 Gemini CLI 或 Antigravity 2.0 里看不到,请更新 skills 安装器,或在 Mem 里重新连接 skills,让新的链接写到这个目录。

如果你的工具有自己专属的复用型工作流包,而不是通用的 skills 路径,就直接使用那份指南。比如 Codex 就应该跟着 Codex 指南 来配置。

有原生连接时,优先用原生连接

如果你的工具已经有专属连接,请优先使用:Claude Code、Grok Build、Gemini CLI、Google Antigravity、Droid、Cursor、OpenClaw、Alma、OpenCode、Amp、Copilot CLI、Pi、OMP、Hermes、Ekko、Proma。这些路径在共享记忆模型之上,还会加入工具专属的行为能力。

面向标准兼容客户端的通用 Agent Plugin

如果你的客户端支持 Agent Plugins,但还没有专属 Nowledge 连接,可以安装这个标准插件包:

https://github.com/nowledge-co/community/tree/main/nowledge-mem-agent-plugin

这个包包含共享记忆 skills 和本地 Mem MCP 配置。它不包含可移植 lifecycle hooks,所以完整会话捕获仍然是原生连接才有的能力。远程 Mem 与验证步骤请看 通用 Agent Plugin 指南。

专属 Nowledge 连接 与完整会话捕获

如果你需要的是真实录制的会话内容,而不是一个可恢复的摘要,那么你走的是哪条连接路径就非常重要。

连接是否有专属 Nowledge 包是否支持完整会话捕获说明
Claude Code是是原生连接,带生命周期钩子与真实会话导入。
Grok Build是是Grok Build 加载共享插件包;hook 会把编程智能体会话以 source=grok 保存。
Gemini CLI是是原生扩展会在 save-thread、压缩前和会话结束时保存真实会话。
Google Antigravity是是原生插件 hook 会把本地 Antigravity transcript.jsonl 会话保存为 canonical source=antigravity;旧会话继续用 nmem t sync --from antigravity 补导。
Droid是目前连接内还不支持原生连接只暴露 save-handoff。在 Droid 还没有真实 transcript 导入器之前,它不会假装提供 save-thread。
Cursor是是原生连接通过 stop hook 捕获当前 transcript;Mem 桌面端和 nmem t sync --from cursor 也可导入历史或遗漏的 ~/.cursor/projects 会话。
OpenClaw是是原生连接会自动捕获真实会话。
Alma是是原生连接支持真实会话捕获。
Codex是是原生连接通过 Stop hook 调用 nmem t save --from codex 捕获真实会话记录。
Copilot CLI是是原生连接会在回复后、压缩前和会话结束时捕获 Copilot 已记录的会话内容。
OpenCode是是原生插件会在 OpenCode 报告 idle 后捕获,并在压缩前 flush。nowledge_mem_save_thread 仍是手动兜底;旧本机会话用 nmem t sync --from opencode 补导。
Amp是是原生插件会在 agent.end 后捕获当前 Amp thread;nowledge_mem_save_thread 仍是幂等的手动兜底。
Kimi CodeKimi 插件 + MCP + 原生 hooks/reload 后自动同步Kimi 插件会直接从 manifest 加载启动指引、MCP 和 lifecycle hooks。旧会话继续用 nmem t sync --from kimi-code 补导。
Kimi WorkKimi Work connector + MCP仅导入Kimi Work 目前不暴露 lifecycle hook。连接器把启动指引和 MCP 放进它的内置运行时;本机会话用 nmem t sync --from kimi-work 显式导入。
ZCodeZCode 插件 + MCP + hooks安装插件后自动ZCode 插件会在 Stop 时复制 hook transcript_path 并用 nmem t sync --from zcode 导入;安装后请用一次短会话验证,因为 hook 行为取决于当前 ZCode build。
MiMo Code目前是 MCP + 指引仅导入nmem t sync --from mimo-code 可从 MiMo Code 的 mimocode.db 导入本机会话;还没有实时 hook 包。
Craft AgentCraft source + guide仅导入Craft 通过 workspace source 使用 MCP 工具,并通过 guide 加载行为规则。nmem t sync --from craft-agent 导入本地 session.jsonl;目前不需要单独发布 npm 包。
CradleCradle 官方内置插件目前为显式保存Agent 可以通过插件创建和追加 Mem Thread;自动会话捕获仍需等待 Cradle lifecycle hook。
ArkloopArkloop 原生 Memory provider是Arkloop 使用稳定链接与幂等键创建并持续追加 source=arkloop Thread。
OpticLMOptic 自己维护的 Thread SDK由宿主决定Optic 公开 SDK 支持 Thread 创建、追加、tail reconcile 与删除;调用时机由 Optic 管理,MCP 是独立的召回路径。
WorkBuddy是是专属连接通过 WorkBuddy lifecycle hooks 捕获主 Agent 与 Subagent transcript,并用稳定 source 和 agent identity 写入 Mem。
CodeBuddy是是专属连接通过 CodeBuddy lifecycle hooks 同步本地 .jsonl transcript,旧会话可用 nmem t sync --from codebuddy 补导。
OMP是是原生插件在 turn 完成后、压缩前、切换会话前和退出时捕获 OMP 对话分支。旧会话继续用 nmem t sync --from omp 补导。
Pi是是原生扩展会同步 Pi 对话;nmem t sync --from pi 可以补导入旧的本地 Pi 会话。
Step Code是是专用扩展在 agent_settled 后同步完整一轮对话;nmem t sync --from step-code 可以补导入旧的本地会话。
Hermes Agent是是原生记忆提供者会捕获新的 Hermes 轮次;nmem t sync --from hermes 可补导入本地 ~/.hermes/state.db 中的旧会话。
Ekko AgentMCP 设置 + CLI 导入器仅导入Ekko 可通过 MCP 使用 Mem;nmem t sync --from ekko 从 $HERMES_WEB_UI_HOME/.ekko/ekko.db 导入已完成的本地 Ekko 会话,自动 post-run 捕获需要 Hermes Studio/Ekko 侧触发。
Proma是是Proma Agent 会话由 UserPromptSubmit 和 Stop hooks 捕获;普通 Proma Chat 对话可从 ~/.proma/conversations/*.jsonl 导入或自动同步。
MirasimMCP + skills否Mirasim 公开了 sessions/history 和 raw recordings,但还没有公开稳定 transcript schema 或 lifecycle hook。Mirasim 启动的 Claude Code 与 Codex pane 应继续使用子工具专属连接。
CindyMCP + skills否Cindy 有 MCP、skills 和 Ghost plugin runtime,但还没有验证过的第三方 transcript 导入路径。Cindy 启动的 Codex、Claude Code、Pi、OMP 会话继续使用子工具专属连接。
通用 Agent Plugin标准兜底包否Agent Plugins 1.0 标准化的是 skills 和 MCP,不包含可移植 lifecycle hooks 或 transcript 访问。
通用 npx skills 智能体没有专属运行时导入器否应使用 save-handoff,而不是 save-thread。共享技能无法在各种宿主上稳定承诺真实 transcript 导入。

为什么通用 skills 不能承诺完整会话捕获

共享 skills 可以影响提示行为,但它并不能决定宿主智能体是否暴露可读取的会话文件,或稳定的 transcript API。正因为如此,通用 npx skills 才应该把 save-handoff 作为默认值。只有专属连接在对应运行时里真正具备能力时,才应该暴露真实的 save-thread。

如果你想看更完整的线程保存与导入矩阵,请继续看 对话指南。

面向自定义智能体的意图控制

原生连接通常已经把行为规则准备好了,会直接告诉智能体何时读取工作记忆简报、何时检索过去知识,以及何时保存真正值得长期保留的信息。

优先用宿主自己的指令文件,不要修改插件缓存

如果宿主本身已经支持用户可持有的指令文件,比如 AGENTS.md、CLAUDE.md、CLAUDE.local.md、GEMINI.md、.cursor/rules/*.mdc,或者 Copilot 的 instruction files,就应该把它们当作长期定制层。已安装插件里的文件只是默认值,不应该当作你要直接修改的地方。

如果你想看完整的“每个宿主应该改哪里”对照表,请直接看 安全地自定义连接行为。

如果你的智能体没有专属插件或扩展,就应该把这层“意图控制”直接写进 AGENTS.md、CLAUDE.md、GEMINI.md 或系统提示中。

先给智能体一个记忆入口

常见做法有三种:

  • 用 npx skills 提供共享技能
  • 让智能体直接看到 nmem CLI
  • 如果客户端支持 MCP,就直接接 MCP 工具

加入一段简短、直接的意图策略

可以把下面这段策略放进 AGENTS.md、CLAUDE.md、GEMINI.md 或系统提示里:

## Nowledge Mem

把 Nowledge Mem 当作你的外部记忆系统。

在会话开始时:
- 如果身份、分区、行为规则或多智能体上下文重要,先运行 `nmem --json context --source-app "<host>"`。
- 只需要轻量日常简报时,再运行 `nmem --json wm read`。
- 如果 Context Bundle 已经包含 Working Memory,不要马上重复读取 Working Memory。
- 如果宿主已经知道当前项目、Agent 或工作区所在的分区,就把 `--space "<space name>"` 一起带上。
- 如果这个 Agent 是由多智能体编排工具启动的,`--source-app` 仍然写子运行时本身,并在子进程环境变量里设置 `NMEM_AGENT_ID="<agent id>"`。

在这些情况下主动搜索:
- 用户提到之前做过的工作、过去修过的问题,或更早的某个决策
- 当前任务是在继续某个已命名的功能、Bug、重构或子系统
- 当前的调试模式很像以前解决过的问题
- 用户在问理由、偏好、流程,或团队反复使用的工作方式

检索路由:
- 先用 `nmem --json m search` 查持久知识。
- 当用户问的是某次过去的讨论,或需要准确的对话历史时,再用 `nmem --json t search`。
- 如果结果里带有 `source_thread`,就用 `nmem --json t show <thread_id> --limit 8 --offset 0 --content-limit 1200` 分页查看,不要一口气加载整条长对话。

在保存知识时:
- 只有真正新的长期知识才用 `nmem --json m add`。
- 如果已有记忆已经记录了同一个决策、偏好或流程,而这次只是补充或修正,请改用 `nmem m update <id> ...`,不要制造重复。
- 交接摘要相关保存只在用户明确要求可恢复的交接摘要时使用。

如果你的智能体只能看到 MCP 工具,也可以沿用同样的策略,只是把命令名替换成工具名:read_working_memory、memory_search、thread_search、thread_fetch_messages、memory_add、memory_update。

Spaces 应该保持为环境上下文

如果宿主本来就知道当前分区,就安静地把它传下去。如果宿主并不知道,就继续留在默认分区,不要平白增加用户心智负担。

对于多 Agent 宿主,更自然的分法通常只有三种:

  • 一个 profile 或一个进程固定落在一个 space
  • 宿主已经知道稳定身份或工作区,再推导出对应的 space
  • 宿主能明确列出少量身份,再把它们映射到命名好的 spaces

如果宿主并没有可靠的身份信号,就不要假装它能做“每个 Agent 一个分区”的自动路由。

有些编排工具会为每个 worker 启动另一个 AI 工具。先连接这个 AI 工具,然后只在真正的“每个 Agent 一个边界”上添加 Mem 身份。

这里的区别很重要:

  • Raft 和 Multica 可以表示命名 worker 或 Agent。为每个 worker 使用一个 Mem 身份。Raft 会中介真正的对话,因此托管 Codex rollout 只是执行轨迹,不会写入 Threads。如果 Multica Agent 使用 Claude Code,把 Mem MCP 配置保存到这个 Multica Agent 上,确保子进程能收到。
  • Lody Agent Config 很多时候只是运行时 preset。只有当某个 config 明确代表一个稳定角色时,才使用 NMEM_AGENT_ID。
  • Cumora 可能只暴露每台电脑一个 daemon。如果多个 teammate 共用它,按 Cumora 指南使用 persona bridge,不要给共享 daemon 设置同一个 NMEM_AGENT_ID。
  • Paseo 会启动 Claude Code、Codex、Copilot、OpenCode 或 Pi。先连接这些子工具;只有当某个 Paseo agent 是长期角色时,才设置 NMEM_AGENT_ID。
  • Cindy 会在一个本地 app 里运行多个 harness。Cindy 内置 agent 用 MCP/skills;需要精确捕获 transcript 时,安装被启动子运行时的专属连接。
nmem agents upsert cindy \
  --name "Cindy" \
  --default-space onboarding \
  --instructions "帮助用户完成 onboarding。一次只解释一个步骤。"

这会创建名为 Cindy 的 Mem AI Identity。命令和环境变量里使用的 ID 是 cindy。这个命令只是创建身份记录;它不会让所有 Codex 会话都变成 Cindy。

当宿主有真正的每 Agent 环境边界时,在那里设置一个环境变量:

NMEM_AGENT_ID="cindy"

把 Cindy 的 ID 理解成 Mem 身份,而不是 Raft 专属设置。以后如果你把 Cindy 从 Raft 换到 Multica,或者把启动的 AI 工具从 Codex 换成 Pi,保留同一个 NMEM_AGENT_ID,只更新工具连接。

如果这个身份已经有默认 Space,就不需要再设置 NMEM_SPACE。只有当这个运行时需要整体覆盖默认 Space 时,再加 NMEM_SPACE="onboarding"。

不要把所有子 Agent 都标成同一个编排工具名。编排工具只是启动者;真正影响 Context Bundle 的,是每个 worker 自己的稳定身份。source_app 仍然使用被启动的 AI 工具,例如 codex、claude-code、opencode 或 pi。NMEM_HOST_AGENT_ID 只适合高级场景,例如把 raft:<uuid> 这类外部 worker ID 映射到一个 Mem 身份;旧的 slock:<uuid> 别名仍然兼容。普通用户不需要同时设置两个身份变量。

只有当子 transcript 就是真实对话时,会话同步才跟随被启动的 AI 工具。Raft 是关键例外:托管 Codex rollout 记录 inbox 通知与执行活动,人类可见回复则经过 Raft 自己的消息通道,因此 Codex connector 会跳过这些 rollout。完整导入 Raft 对话,需要 Raft 原生 export、API 或 hook。

如果你需要“像 Cindy,但不完全一样”的变体,明确 fork 一个新身份,例如 cindy-reviewer。不要因为编排工具里可以复用同一个名字,就把互相冲突的工作方式塞进同一个身份。

具体平台设置见 Raft、Lody、Multica、Cumora、Paseo 和 Cindy。

保持策略短、直接、可执行

最有效的意图提示,不是长篇说明,而是直接告诉智能体:

  • 何时读取工作记忆简报
  • 何时主动搜索
  • 何时使用对话工具,而不是 memory_search
  • 何时新增记忆,何时更新已有记忆
  • 何时交接摘要只能在用户明确要求时执行

模型上下文协议 (MCP)

MCP 是 Nowledge Mem 面向通用客户端的兼容层。只有当你的客户端支持 MCP、但没有专属的 Nowledge 连接时,才应该优先走这条路径。

专属连接、复用包 与 直接 MCP

路径适用场景示例
原生连接你的工具已经有专属的 Nowledge 包Claude Code 插件、Grok Build 插件、Codex 包、Gemini CLI 扩展、OpenClaw 插件、Hermes 记忆提供者、Proma 插件、Alma 插件、Cursor 插件、Droid 插件、OpenCode 插件、Copilot CLI 插件、Pi 技能包、OMP 插件
宿主官方集成应用自己发布并维护 Nowledge 路径Cradle 内置插件、Arkloop Memory provider、OpticLM Thread bridge
通用 Agent Plugin客户端支持 Agent Plugins,但还没有专属 Nowledge 连接nowledge-mem-agent-plugin
直接 MCP客户端支持 MCP,你需要标准工具访问Cursor 手动 MCP 配置、Claude Desktop、ChatWise、GitHub Copilot
复用型工作流包你的智能体可以安装共享技能或提示词,但没有 MCP 工具面npx skills

如何理解 MCP

当有专属连接时,优先使用专属连接。它们底层可能会用到 nmem、MCP、工具原生生命周期钩子,或者几者混合,但对终端用户来说,首先应该按“我装的是哪种入口”来理解,而不是先去理解底层传输方式。对 Codex 这类少数宿主来说,MCP 不是替代插件的另一条路,而是建议和插件一起用的 companion。

MCP 能力

  • 搜索记忆:memory_search
  • 读取 Context Bundle:read_context_bundle
  • 读取工作记忆简报:read_working_memory
  • 添加记忆:memory_add
  • 更新记忆:memory_update
  • 列出记忆标签:list_memory_labels
  • 查找已保存对话:thread_search、thread_fetch_messages、search_thread_messages
  • 提示词:sum(把稳定的决策、流程和经验提炼为记忆)

MCP 不负责导入本地 transcript 文件。你的工具有原生连接时,优先使用原生连接;否则请在运行智能体的那台机器上执行 nmem t save --from claude-code、nmem t save --from grok、nmem t save --from codex、nmem t save --from gemini-cli 或 nmem t sync --from antigravity。这样采集始终发生在本机,本地 Mem 和远程 Mem 使用同一条可靠路径。

MCP 服务器配置

自主行为的系统提示

对于只支持 MCP 的应用,把下面这段策略加入系统提示、CLAUDE.md 或 AGENTS.md,就能让智能体更主动、更稳定地使用记忆能力:

## Nowledge Mem 记忆工具

你可以使用 Nowledge Mem 进行知识管理,请主动使用这些工具:

**会话开始时(`read_working_memory`):**
- 调用 `read_working_memory` 获取今日简报
- 了解用户当前的关注领域、优先事项和未解决问题
- 在与当前任务相关时自然引用这些上下文
- 如果任务明显是在续接、复盘、查回归、准备发布,或追问过去的决策,不要停在简报这里,继续做一次有针对性的检索

**何时搜索(`memory_search`):**
- 当前话题与之前的工作有关联
- 当前问题与过去解决过的问题类似
- 用户询问过去的决策("我们为什么选择 X?")
- 复杂调试,可能匹配过去的根本原因
- 复盘、发布、文档对齐、连接行为异常这类问题,通常也值得在前面就先查一次

**何时搜索对话(`thread_search` / `thread_fetch_messages`):**
- 用户在问某次之前的讨论或具体对话历史
- 某条记忆结果指向来源对话
- 按页逐步抓取消息,不要一次性倾倒整条长对话
- 只有在确实需要之前那段讨论本身时,再升级到对话检索

**何时保存记忆(`memory_add`):**
- 解决复杂问题或完成调试后
- 做出重要决策并附带理由时
- 发现关键洞察("原来如此"时刻)后
- 整理流程或工作方式时
- 在一段实质性工作结束前,主动检查一次:是否应该新增或更新一条真正值得留下的记忆
- 跳过:常规修复、进行中的工作、普通问答
- 已经知道类型时,传入 `unit_type`:`fact`、`preference`、`decision`、`plan`、`procedure`、`learning`、`context` 或 `event`

**何时更新已有记忆(`memory_update`):**
- 在保存前先搜索,看这个主题是否已经存在
- 如果检索结果已经包含同一个决策、偏好或流程,就更新原有记忆,而不是再新增一条近似重复的内容
- 当新信息是在补充、修正或延伸已有知识时,优先使用更新

这能让仅支持 MCP 的应用进入“有引导”的主动记忆模式。但它仍然不等于 hook 驱动的原生连接。所以,只要你的宿主已经有专属 Nowledge 包,优先走专属路径。

浏览器扩展

从受支持的 Web AI 聊天平台捕获记忆,支持自动捕获、手动提炼和对话备份。

对话

导入和管理来自编程工具、导出文件、API 或命令行的对话。

工具指南

按你实际使用的产品来找对应的安装与配置指南。这里既包含原生连接,也包含内置路径和可复用工作流包。

如果你想在安装后确认这条路径是否真的已经生效,请配合 如何确认 Mem 已经在工作 一起使用。

连接你会得到
Claude Code插件含生命周期钩子,开局读简报,适时保存
DroidFactory 插件,带工作记忆简报、路由式检索、提炼与可恢复的交接摘要
Cursor插件包内含启动钩子、MCP 配置、路由式检索、提炼与可恢复交接摘要
Claude Desktop一键安装的扩展,对话中随时保存、搜索、更新记忆
CodexCodex 的 hybrid 路径:自动启动上下文、两套记忆路由、内置 MCP 与自动线程捕获
OpenCode原生连接:Context Bundle、Working Memory、搜索/保存工具、idle 自动会话捕获、压缩前 flush 与可恢复交接
Pi原生包:Working Memory、路由检索、知识蒸馏、自动线程同步和交接摘要
Step Code专用插件包:启动上下文、settled-turn 自动同步、技能和旧会话补导
Kimi CodeKimi 原生插件:上下文、检索、记忆保存、hook 同步与旧 transcript 导入
Kimi Work面向 Kimi Work 内置运行时的连接器:启动上下文、MCP 记忆工具和显式本机会话导入
ZCodeZCode 原生插件:MCP、Skills、命令、启动/检索 hooks 与 Stop-hook transcript 捕获
MiMo Code面向 Xiaomi MiMo 编程智能体的 MCP 记忆、项目指引与按需 transcript 导入
Cradle官方内置插件,提供引导式 Working Memory、Context Bundle、记忆与 Thread 操作,并可选注册 MCP
Arkloop原生 Memory provider,自动加载 Working Memory、召回相关知识、保存 Arkloop Thread,并可选提炼长期知识
OpticLMOptic 自己维护的 Space 与 Thread bridge;标准 Mem MCP 作为独立的 Agent 召回路径
OMP面向 Pi 衍生 OMP 编程智能体的启动上下文、自动线程捕获、技能和按需补导
Hermes Agent原生记忆提供者:Working Memory 启动、每轮前检索、保存指引与会话线程搜索工具
Ekko AgentHermes Studio 内置 Agent:MCP 负责上下文和记忆工具,nmem t sync --from ekko 从本地 SQLite 导入真实会话
Proma桌面智能体接入方式:MCP 工具、写入 CLAUDE.md 的启动上下文、Proma Agent 自动保存、Proma Chat 导入和标准 skills
Mirasim多智能体工作台通过 MCP 和共享 skills 接入 Mem;Claude Code 与 Codex pane 仍保留各自专属 transcript 连接
CindyCindy host 通过 MCP 和共享 skills 接入 Mem;Cindy 启动的 Codex、Claude Code、Pi、OMP 会话仍保留各自专属 transcript 连接
Gemini CLI原生扩展,内含 MCP、生命周期钩子、命令与技能,并由 nmem 负责真实会话保存
Grok Build编程智能体插件路径,提供启动上下文、记忆引导与自动本机会话捕获
Alma插件含自动回忆和可选的自动捕获
OpenClaw含生命周期和回归测试的完整配置指南
Raycast四个命令:搜索、添加、读取工作记忆简报,以及本地编辑简报
DeepChat · LobeHub内置支持,开关即用,无需配置 MCP

相关指南: Claude Code · Grok Build · Droid · Cursor · Claude Desktop · Codex · OpenCode · Pi · Kimi Code · Kimi Work · ZCode · MiMo Code · Cradle · Arkloop · OpticLM · WorkBuddy · CodeBuddy · OMP · Hermes Agent · Ekko Agent · Proma · Mirasim · Cindy · Gemini CLI · Alma · OpenClaw · 通用 Agent Plugin · Raycast · 内置 Web 聊天

LLM 友好文档

本文档站的每一页都可以作为干净的 Markdown 供 AI 智能体和 LLM 使用:

curl -H "Accept: text/markdown" https://mem.nowledge.co/docs/integrations
端点返回内容
/llms-full.txt所有文档页面合并为一个文件
/llms.mdx/docs/<slug>单页 Markdown

无需认证。

API

RESTful API,完整访问你的知识库。

命令行界面 (CLI)

nmem CLI 提供终端下的知识库访问,面向开发者和 AI 智能体。

安装

平台安装方式
macOS设置 → 偏好设置 → 开发者工具 → 安装 CLI
Windows随应用自动安装
Linux包含在 deb/rpm 包中

快速上手

# 检查连接
nmem status

# 搜索记忆
nmem m search "项目笔记"

# 创建记忆
nmem m add "重要洞察" --title "项目学习"

# 保存 Claude Code/Grok Build/Codex/Gemini 会话
nmem t save --from claude-code
nmem t save --from grok
nmem t save --from codex -s "本次完成的内容摘要"
nmem t save --from gemini-cli -s "本次完成的内容摘要"

AI 智能体

# JSON 输出,便于解析
nmem --json m search "API 设计"

# 链式命令
ID=$(nmem --json m add "笔记" | jq -r '.id')
nmem --json m update "$ID" --importance 0.9

命令参考

命令别名描述
nmem status检查服务器连接
nmem stats数据库统计
nmem memoriesnmem m记忆操作
nmem threadsnmem t对话操作

完整文档

运行 nmem --help 或查看 GitHub 上的 CLI 参考。

展示你的连接

用 API 或 CLI 做了什么?在 GitHub 或 Discord 分享。

下一步

On this page