check-integration

检查连接器

验证 Nowledge Mem 是否正在运行，并为用户推荐最适合其 Agent 的连接器。

适用场景

• 用户询问 Nowledge Mem 的设置或配置
• 记忆工具无法使用或不可用
• 用户询问“我的记忆功能正常吗？”或“如何设置 Nowledge Mem？”
• 首次在此 Agent 中使用 Nowledge Mem
• 用户询问如何从技能升级到原生连接器

步骤 1：检查 nmem CLI

nmem --json status

修复任何问题前，先遵循以下规则：

• 与 Nowledge Mem Desktop 在同一台机器上： 使用桌面应用附带的 nmem。请用户打开 Nowledge Mem；如果仍找不到命令，请使用 Settings → Preferences → Developer Tools → Install bundled CLI。
• 在另一台机器上： 在这台机器上安装独立的 PyPI 软件包 nmem-cli，然后将其指向用户的 Mem 服务。此方案适用于远程服务、开发机、CI 运行器、托管 Agent 和 SSH 机器。需要 Python 3.11+。

除非用户明确要求使用独立 CLI，否则不要在用户自己的桌面设备上用 PyPI CLI 覆盖桌面应用附带的 CLI。

如果 Agent 不在桌面机器上，且找不到 nmem，请安装 PyPI CLI：

python3 -m pip install --user nmem-cli
# or: pipx install nmem-cli
# or for one-off checks: uvx --from nmem-cli nmem --json status

nmem config client set url https://<their-mem-server>
nmem config client set api-key nmem_...
nmem --json status

如果 nmem 存在但状态检查失败，则此机器无法访问 Nowledge Mem。请引导用户：

• 本地桌面：打开 Nowledge Mem 应用，然后重试 nmem --json status
• 远程/客户端机器：使用 nmem config client show 验证 URL/API 密钥
• 完整安装指南：https://mem.nowledge.co/docs/installation
• 远程访问指南：https://mem.nowledge.co/docs/remote-access

步骤 2：检测 Agent 并推荐最佳方案

全新安装时，请从通用连接技能开始：

Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update Nowledge Mem for the AI tool I am using.

将此检查集成技能用作诊断备用方案：确认已安装的内容，说明用户应预期的行为，并在配置失败时进行修复。

不要只回答“安装 X”。要说明用户将获得的行为约定：

1. 哪些内容会自动启动
2. 哪些内容仅由技能/规则引导，仍由模型驱动
3. 对话线程是自动捕获、显式保存，还是仅支持作为交接摘要

按以下优先顺序选择：

1. 宿主提供原生连接器时，优先使用原生连接器
2. 宿主支持 Agent Plugins 但没有原生连接器时，使用通用 Agent Plugin
3. 宿主支持 MCP 但没有更合适的软件包方案时，使用直接 MCP
4. 宿主支持共享技能/提示词，但不支持原生连接器、Agent Plugins 或 MCP 工具接口时，使用可复用软件包

新用户关注的是结果，而不是传输方式。请告诉他们设置完成后实际能获得什么。

自主性级别

方案	通常会发生什么	无法保证什么
原生连接器	配置能力最强：会话引导通常会自动进行；某些宿主还会添加自动捕获或由钩子驱动的回忆功能	精确的主动回忆/提炼时机仍可能因宿主而异
通用 Agent Plugin	为没有专用连接器的兼容客户端提供标准 Agent Plugins 软件包，其中包含共享技能和本地 Mem MCP	Agent Plugins 1.0 不提供可移植的生命周期钩子或对话记录访问能力
直接 MCP	工具可用；使用推荐的提示词区块后，Agent 可以主动使用这些工具	仅靠 MCP 无法实现由宿主强制执行的自主性
可复用软件包	工作记忆、回忆和提炼由规则/技能引导	如果提示词和项目指引不够明确，宿主仍可能忽略这些引导

检查正在运行的 Agent，并在有原生连接器时优先推荐该连接器。

此表的权威来源是 community/integrations.json。

Agent	检测方式	连接器设置	文档
Claude Code	正在作为 Claude Code Agent 运行；~/.claude/ 存在	claude plugin marketplace add https://github.com/nowledge-co/community && claude plugin install nowledge-mem@nowledge-community	指南
Grok	正在作为 Grok 运行；~/.grok/ 存在	grok plugin install nowledge-co/community#nowledge-mem-claude-code-plugin --trust	指南
Grok Bot	正在配置云托管的 Grok Bot；预计不会在本地安装 CLI	在 Grok Bot 设置中添加带有公共 HTTPS 端点的自定义 Nowledge Mem MCP 连接器。如果 Bot 或团队提供兼容的 Plugins 设置，请在那里启用共享包，以支持相应的技能/钩子。请勿使用 localhost 或 127.0.0.1；要自动捕获完整对话线程，仍需使用有文档说明的 Bot 对话记录导出或钩子载荷。	指南
OpenClaw	正在作为 OpenClaw Agent 运行；~/.openclaw/ 存在	openclaw plugins install clawhub:@nowledge/openclaw-nowledge-mem	指南
Cursor	正在 Cursor IDE 中运行	将社区仓库中的 nowledge-mem-cursor-plugin 复制到 ~/.cursor/plugins/local/nowledge-mem-cursor，然后重新加载 Cursor	指南
Gemini CLI	正在作为 Gemini CLI Agent 运行；~/.gemini/ 存在	gemini extensions install https://github.com/nowledge-co/nowledge-mem-gemini-cli --auto-update，或从 Extensions Gallery 安装 “Nowledge Mem”	指南
Google Antigravity	正在作为 Antigravity 运行；~/.gemini/config/plugins/ 或 ~/.gemini/antigravity/ 存在	安装原生插件：mkdir -p ~/.gemini/config/plugins && git clone --depth 1 https://github.com/nowledge-co/nowledge-mem-google-antigravity.git ~/.gemini/config/plugins/nowledge-mem，然后重启 Antigravity。对于远程 Mem，运行 nmem config mcp show --host google-antigravity，并将生成的 serverUrl MCP 配置块粘贴到 Antigravity 的 MCP 设置中。使用 nmem t sync --from antigravity 预览较早的历史记录；仅对旧的缓存会话使用 Trajectory Extractor。	指南
Alma	正在 Alma 中运行；~/.config/alma/ 存在	在 Alma 中：Settings > Plugins > Marketplace，搜索 “Nowledge Mem”	指南
Droid	正在 Droid (Factory) 中运行	添加 nowledge-co/community 市场，并安装 nowledge-mem@community	指南
OpenHands	正在 OpenHands 或 OpenHands SDK 中运行	使用 Plugin.load("path/to/nowledge-mem-openhands-plugin") 加载 nowledge-mem-openhands-plugin，或将其复制到 .openhands/plugins/nowledge-mem。	包指南
CodeBuddy	正在 CodeBuddy Code 中运行	codebuddy plugin marketplace add nowledge-co/community && codebuddy plugin install nowledge-mem@nowledge-community，然后重启 CodeBuddy	指南
WorkBuddy	正在 WorkBuddy 中运行	桌面端 Plugins -> +：添加 https://raw.githubusercontent.com/nowledge-co/community/main/.workbuddy-plugin/marketplace.json，安装并启用 Nowledge Mem，重新加载，然后检查 MCP Trust。使用插件卡片上的 Update；仅当宿主提供插件斜杠命令时，才可将其作为替代方式。	指南
Codex	正在 Codex 桌面应用或 Codex CLI 中运行；~/.codex/ 存在	codex plugin marketplace add nowledge-co/community --sparse .agents --sparse nowledge-mem-codex-plugin && codex plugin add nowledge-mem@nowledge-community，启用 [features] plugins = true、hooks = true 和 [plugins."nowledge-mem@nowledge-community"] enabled = true，然后运行已安装的 scripts/install_hooks.py。仅当宿主仍需要时，才会添加旧版 plugin_hooks 门控项。重启 Codex，并在出现提示时信任 Nowledge Mem 钩子。如果启用了 Codex 本地 Memory，请关闭 Allow memory generation from tool-assisted tasks。	指南
Bub	正在 Bub 中运行	pip install nowledge-mem-bub	指南
Pi	正在作为 Pi Agent 运行；~/.pi/ 存在	pi install npm:nowledge-mem-pi	指南
DimAgent	正在 DimAgent 中运行；~/.dim/ 存在或已设置 DIMCODE_HOME	升级到支持原生 DimAgent 导入的 Mem 版本后，通过 DimAgent 兼容 Codex 的插件流程安装 nowledge-mem-dimagent-plugin，重启 DimAgent，并在出现提示时信任其生命周期钩子。目前尚未发布经验证的宿主专用市场命令。	包指南
OMP	正在作为 OMP Agent 运行；~/.omp/ 存在	omp plugin install nowledge-mem-omp	指南
OpenCode	正在作为 OpenCode Agent 运行；~/.config/opencode/ 或 .opencode/ 存在	检查 opencode --version。1.x： opencode plugin [email protected] --global。2.x： opencode plugin add opencode-nowledge-mem（默认全局安装）。重启 OpenCode 以加载其钩子	指南
Amp	正在作为 Amp Agent 运行；~/.config/amp/ 或 .amp/ 存在	运行 bash nowledge-mem-amp-plugin/scripts/install.sh，然后重启 Amp，以加载工具、agent.end 捕获钩子和技能	指南
Craft Agent	正在 Craft Agent 中运行；~/.craft-agent/ 存在或已设置 CRAFT_CONFIG_DIR	运行 nmem config mcp show --host craft-agent，然后将生成的源配置和指南添加到当前 Craft 工作区。使用 nmem t sync --from craft-agent --all-projects --apply 导入实际会话。	指南
Hermes Agent	正在作为 Hermes Agent 运行；~/.hermes/ 存在	安装原生 Hermes 提供程序（或仅在备用情况下使用 MCP）	指南
Cradle	正在 Cradle 中运行；插件市场中显示捆绑的 nowledge-mem 集成	启用 Cradle 捆绑的 Nowledge Mem 插件。按需配置其 API URL、可选的 MCP URL、Space 和仅限运行时使用的 API 密钥。	指南
Arkloop	正在 Arkloop 中运行；Settings > Memory 中列出了 Nowledge	启用 Memory，选择 Nowledge，然后检测本地实例或输入 Base URL、API Key 和超时时间。	指南
iCode	正在 iCode (Chrys) 中运行；~/.chrys/ 存在或已设置 CHRYS_SESSION_ROOT_DIR	从社区仓库检出目录运行 nowledge-mem-icode-plugin/scripts/install.py，然后重启 iCode。该脚本会将 nowledge-mem MCP 服务合并到 Agent 配置文件中，安装 user_prompt_submit 上下文钩子，并复制共享技能。通过 /agents > MCP 和新会话中的首次提示词进行验证。	包指南
OpticLM	正在 Optic 中运行；扩展设置中提供 Nowledge Mem	启用 Optic 内置集成。如果还需要 Working Memory、搜索或持久化记忆工具，请单独添加直接的 Mem MCP。	指南
如需更新 Hermes，请运行指南中的安装命令，并确认输出 Thread import endpoint: /threads/import。如果输出的是旧端点或没有端点，用户可能使用了不同的 HERMES_HOME 启动 Hermes；请明确设置该变量，并在重启前重新运行安装命令。

如果上方未列出该 Agent：

• 如果宿主支持 Agent Plugins，请使用 Universal Agent Plugin
• 否则，请使用直接 MCP 加推荐的提示词块
• 如果宿主支持共享技能但没有 MCP 工具界面，请使用共享的 npx skills 包

不要将原始 MCP 描述为等同于原生连接器。

第 3 步：验证

安装完成后，运行以下命令进行验证：

nmem --json m search "test" -n 1

如果返回结果（或无错误地返回空列表），说明连接器正常工作。

然后用通俗语言说明预期效果：

• 工作记忆：自动、引导式或手动
• 回忆：自动、引导式或手动
• 提炼：自动、引导式或手动
• 会话线程：自动捕获、显式保存、仅交接或无

如果该路径仅为 guided，请说明如何增强效果：

• 在本地保持 nmem 可用
• 安装后重启宿主
• 在有建议时合并软件包的 AGENTS.md 或同等的代码库指南
• 将本地 nmem 客户端配置为远程模式

原生连接器的额外功能

技能提供基于 CLI 的记忆访问能力。原生连接器通常还会增加：

• 自动回忆：在每次回复前注入相关记忆（无需手动搜索）
• 自动捕获：在会话结束时将对话保存为可搜索的线程
• 大模型提炼：自动提取关键决策和见解
• 图谱工具：探索关联、演进链和实体关系
• 工作记忆：在会话开始时加载或注入每日简报
• 斜杠命令：/remember、/recall、/forget（在支持的情况下）

不要承诺所有宿主都具备上述全部功能。请根据用户实际设置的路径进行说明。

链接

• 所有连接器
• 文档
• Discord 社区