Hermes Agent × Nowledge Mem
Hermes v0.7.0+ 原生记忆提供者。Working Memory 自动加载，相关知识在每轮对话前浮现，并提供原生保存工具与跨工具知识指引。
bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh)原生插件集成
Hermes v0.7.0+ 支持记忆提供者插件。安装一次后，Working Memory 会在会话开始时加载，相关记忆会在每轮对话前浮现，同时 Hermes 还会拿到原生的 Nowledge 工具与保存指引。无需配置 SOUL.md 行为指引。
在上游合并前
在这个提供者被 NousResearch/hermes-agent 正式接收之前，当前推荐安装路径仍然是本页提供的 Nowledge 社区安装脚本。上游合并后它会成为长期正式入口；在那之前，这份指南会明确保留可用的过渡路径，避免用户卡住。
跨工具的知识，在每次 Hermes 会话中都可用。在 Claude Code 中做的决策、在 Cursor 中设定的偏好、在 ChatGPT 中获得的洞察，汇聚成一个知识图谱，随时可以调用。
安装成功的标志
安装插件并重启 Hermes 后，开始一个新会话。Working Memory 应出现在系统提示中。问一句"我最近做了哪些决策？"，Hermes 应该直接搜索你的知识图谱，不需要你指定工具。
准备工作
- Nowledge Mem 已在本地运行（安装指南）或可访问的远程服务器
- Hermes Agent v0.7.0+（v0.6.x 可使用 MCP 模式）
nmem status # 确认 Nowledge Mem 正在运行
hermes --version # 确认 Hermes 可用安装
插件安装（推荐）
bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh)安装原生记忆提供者插件。运行后重启 Hermes。
也可以手动安装：
- 将插件文件复制到
~/.hermes/plugins/nowledge-mem/：mkdir -p ~/.hermes/plugins/nowledge-mem cd ~/.hermes/plugins/nowledge-mem for f in plugin.yaml __init__.py provider.py client.py; do curl -sLO "https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/$f" done - 在
~/.hermes/config.yaml中设置提供者：memory: provider: "nowledge-mem" - 重启 Hermes。
MCP 模式（Hermes < v0.7.0）
如果你使用较早版本的 Hermes，或者偏好标准 MCP 连接：
bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh) --mcp这会在 config.yaml 中添加 MCP 服务器配置，并将行为指引写入 ~/.hermes/SOUL.md。工具名称带有 mcp_nowledge_mem_ 前缀。
MCP 模式下，如果缺少行为指引，Hermes 虽然能访问工具，但不会主动使用。如果 Hermes 能检索记忆却从不主动保存，通常就是指引缺失。插件模式不需要额外的 SOUL 指引，因为这部分提示已经内置在提供者里。
验证
问 Hermes 一个依赖过去工作的问题：
我最近做了哪些决策？插件模式下，Hermes 应调用 nmem_search。MCP 模式下，应调用 mcp_nowledge_mem_memory_search。然后你可以让 Hermes 把结论存成记忆，或者观察它是否会在对话达到稳定结论时主动调用 nmem_save。
自动化行为
插件接入了 Hermes 的记忆提供者生命周期，以下行为无需手动触发：
- Working Memory 在每次会话开始时自动加载
- 相关记忆 在每轮对话前自动浮现（主动召回）
- 用户画像 从 Hermes 内置记忆同步到跨工具知识图谱
- 上下文压缩器 知晓外部知识的存在，可通过搜索恢复
MCP 模式下，这些行为依赖 SOUL.md 中的行为指引，无法完全保证。
Hermes 记忆 vs Nowledge Mem
Hermes 自带的记忆系统存储 Hermes 会话中的特定信息。Nowledge Mem 是互补的：它存储跨工具的知识。两者配合使用：
- Hermes 记忆：Hermes 特有的偏好、环境信息、工具习惯
- Nowledge Mem：决策、流程和经验，未来在任何工具中都应该知道的知识
插件会自动将 Hermes 中的用户画像同步到 Nowledge Mem，让跨工具知识保持一致。
你能做什么
在 Hermes 中查找其他工具的知识。 问一句"数据库方案之前定了什么？"，Hermes 会搜索你在 Claude Code、ChatGPT、Cursor 中积累的决策和洞察。
保存知识，全局可用。 在 Hermes 中得出结论后，你可以让它调用 nmem_save 保存到知识图谱；下次打开 Claude Code、Cursor 或 ChatGPT 时都能继续用。
搜索历史对话。 按关键词搜索所有工具中的历史对话，支持分页获取完整记录。
MCP 模式下还可以使用图谱探索工具，追溯决策的演变过程和发现关联记忆。
工具一览
插件模式使用简洁的 nmem_ 前缀。MCP 模式使用 mcp_nowledge_mem_ 前缀。
| 插件模式 | MCP 模式 | 说明 |
|---|---|---|
nmem_search | memory_search | 搜索记忆 |
nmem_save | memory_add | 保存或更新决策、洞察或经验 |
nmem_update | memory_update | 更新已有记忆 |
nmem_delete | memory_delete | 删除一条或多条记忆 |
nmem_thread_search | thread_search | 搜索历史对话 |
nmem_thread_messages | thread_fetch_messages | 获取对话消息 |
MCP 模式还包含 list_memory_labels、memory_neighbors 和 memory_evolves_chain。待 nmem CLI 支持后会添加到插件中。
配置
本地使用无需任何配置。插件通过 nmem CLI 操作，服务器地址和 API 密钥由 CLI 管理。
如果 Nowledge Mem 桌面应用在同一台机器上，nmem 已经内置。远程环境下如果没有桌面应用，可以安装：pip install nmem-cli。
远程访问
配置当前机器上的 nmem 客户端，让它指向远程服务器：
nmem config client set url https://your-server:14242
nmem config client set api-key your-key这一步修改的是 Hermes 所在机器的客户端连接配置，不是 Mem 服务器端的 Access Anywhere 或局域网监听配置。
插件唯一的独立配置是请求超时，保存在 ~/.hermes/nowledge-mem.json：
{
"timeout": 60
}Spaces
Hermes 现在支持三种干净的 lane 设计：
space：当前 Hermes profile 固定使用一个 spacespace_by_identity：把少量明确身份映射到命名好的 spacesspace_template：如果 Hermes 已经暴露稳定 identity，就按模板派生 space
如果这些都没配置，Hermes 仍然可以继承 NMEM_SPACE。
MCP 模式下，直接在 config.yaml 中更新地址：
mcp_servers:
nowledge-mem:
url: "https://your-server/mcp"
headers:
Authorization: "Bearer your-key"
timeout: 120参见随处访问 Mem。
更新
MCP 工具由 Nowledge Mem 服务器提供，更新桌面应用后自动更新。插件更新需要重新运行安装命令。
常见问题
无法连接 Nowledge Mem。 用 nmem status 确认服务器正在运行，检查地址是否匹配。
Hermes 能检索但从不主动保存（MCP 模式）。 行为指引缺失。运行安装命令后重启 Hermes。指引需要在 ~/.hermes/SOUL.md（每次会话都加载）或项目级 HERMES.md（在 git 根目录）中。插件模式下这部分保存提示已内置在提供者中，不需要额外指引。
工具未出现（插件模式）。 确认 config.yaml 中设置了 memory.provider: "nowledge-mem"，且插件文件存在于 ~/.hermes/plugins/nowledge-mem/。重启 Hermes。
工具未出现（MCP 模式）。 确认 config.yaml 中有 mcp_servers.nowledge-mem 配置块。重启 Hermes。检查 YAML 格式是否正确。
响应缓慢。 默认超时为 30 秒。在 nowledge-mem.json（插件模式）或 config.yaml（MCP 模式）中调大超时值。如果问题持续，用 nmem status 检查服务器状态。
相关
- 集成概览
- Claude Code · OpenCode · Pi · OpenClaw · Alma · Bub
- 源码：nowledge-mem-hermes