Hermes Agent × Nowledge Mem
Hermes v0.7.0+ 原生记忆提供者。Working Memory 自动加载，相关知识会在每轮前浮现，并且会把清洗后的对话轮次同步成 Mem 线程。
给你的智能体
把这行交给你的智能体。它应该先读取当前指南，再改配置或运行命令：
读取 https://mem.nowledge.co/docs/integrations/hermes.mdx，然后帮我为 Hermes Agent 安装或更新 Nowledge Mem。优先使用指南中的推荐路径，按成功检查验证结果，并总结你改了什么。bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh)原生插件集成
Hermes v0.7.0+ 支持记忆提供者插件。安装一次后，Working Memory 会在会话开始时加载，相关记忆会在每轮对话前浮现，并且 Hermes 会在对话进行中把清洗后的轮次同步成 Mem 线程。无需配置 SOUL.md 行为指引。
在上游合并前
在这个提供者被 NousResearch/hermes-agent 正式接收之前，当前推荐安装路径仍然是本页提供的 Nowledge 社区安装脚本。上游合并后它会成为长期正式入口；在那之前，这份指南会明确保留可用的过渡路径，避免用户卡住。
跨工具的知识，在每次 Hermes 会话中都可用。在 Claude Code 中做的决策、在 Cursor 中设定的偏好、在 ChatGPT 中获得的洞察，汇聚成一个知识图谱，随时可以调用。
安装成功的标志
安装插件并重启 Hermes 后，开始一个新会话。发一条包含唯一短语的消息，然后正常退出、执行 /new 或执行 /reset。运行 nmem t search "这条短语" --source hermes 应能找到被捕获的 Hermes 对话。如果你的 Mem 里已经有记忆，再问一句"我最近做了哪些决策？"，Hermes 应该直接搜索你的知识图谱，不需要你指定工具。
准备工作
- Nowledge Mem 已在本地运行（安装指南）或可访问的远程服务器
- Hermes Agent v0.7.0+（v0.6.x 可使用 MCP 模式）
nmemCLI 已在PATH中。如果桌面应用就在这台机器上，使用 Settings → Preferences → Developer Tools → Install CLI。如果是纯远程机器，执行pip install nmem-cli。
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 smoke test然后正常退出 Hermes，或执行 /new / /reset，让 Hermes 做最后一次对话刷新。在终端里检查：
nmem t search "hermes nmem smoke test" --source hermes你应该能看到来源为 Hermes 的对话。随后，如果你的 Mem 里已经有记忆，再问一个依赖过去工作的问题：
我最近做了哪些决策？插件模式下，Hermes 应调用 nmem_search。MCP 模式下，应调用 mcp_nowledge_mem_memory_search。然后你可以让 Hermes 把结论存成记忆，或者观察它是否会在对话达到稳定结论时主动调用 nmem_save。
自动化行为
插件接入了 Hermes 的记忆提供者生命周期，以下行为无需手动触发：
- Working Memory 在每次会话开始时自动加载
- 相关记忆 在每轮对话前自动浮现（主动召回）
- 用户画像 从 Hermes 内置记忆同步到跨工具知识图谱
- 会话记录 会在轮次完成时同步成 Mem 线程，并在 Hermes 正常退出、开启新会话或重置会话时做最后一次增量刷新
- 压缩恢复提示 会在当前 Hermes 版本实际消费 provider 压缩输出时生效
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 时都能继续用。
搜索历史对话。 按关键词搜索所有工具中的历史对话，支持分页获取完整记录。
让 Hermes 会话也可搜索。 提供者会在对话进行中把清洗后的 user / assistant 轮次保存成 Mem 线程。正常退出、执行 /new 或 /reset 时，会再做一次最后的增量刷新。每个 Hermes session_id 第一次写入时导入线程，后续只追加新增轮次。
MCP 模式下还可以使用图谱探索工具，追溯决策的演变过程和发现关联记忆。
工具一览
插件模式使用简洁的 nmem_ 前缀。MCP 模式使用 mcp_nowledge_mem_ 前缀。
| 插件模式 | MCP 模式工具名 | 说明 |
|---|---|---|
nmem_search | mcp_nowledge_mem_memory_search | 搜索记忆 |
nmem_save | mcp_nowledge_mem_memory_add | 保存或更新决策、洞察或经验 |
nmem_update | mcp_nowledge_mem_memory_update | 更新已有记忆 |
nmem_delete | mcp_nowledge_mem_memory_delete | 删除一条或多条记忆 |
nmem_thread_search | mcp_nowledge_mem_thread_search | 搜索历史对话 |
nmem_thread_messages | mcp_nowledge_mem_thread_fetch_messages | 获取对话消息 |
MCP 模式还包含 list_memory_labels、memory_neighbors 和 memory_evolves_chain。待 nmem CLI 支持后会添加到插件中。
配置
本地使用无需任何配置。插件使用共享的 nmem 客户端配置来读取服务器地址和 API 密钥。常规记忆操作走 nmem，较长的会话记录会直接发送到 Mem API。
如果 Nowledge Mem 桌面应用在同一台机器上，nmem 已经内置。远程环境下如果没有桌面应用，可以安装：pip install nmem-cli。
远程访问
配置当前机器上的 nmem 客户端，让它指向远程服务器：
nmem config client set url https://your-server
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。
更新
沿用你当前安装时选择的模式：
- 插件模式，Hermes v0.7.0+ 的默认路径：不加参数重新运行 setup，然后重启 Hermes。
- MCP 模式，适合 Hermes v0.6.x 或你有意保留标准 MCP 接入：带
--mcp重新运行 setup，然后重启 Hermes。
# 插件模式
bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh)
# MCP 模式
bash <(curl -sL https://raw.githubusercontent.com/nowledge-co/community/main/nowledge-mem-hermes/setup.sh) --mcpMCP 工具本身由 Nowledge Mem 提供，更新桌面应用后自动更新。Hermes 插件文件则通过这个 setup 脚本更新。
禁用或回退
修改文件前先退出 Hermes。
- 插件模式：把
~/.hermes/config.yaml里的memory.provider改回你之前使用的 provider；如果你以前没有启用 Hermes memory，就删除这一行。然后删除~/.hermes/plugins/nowledge-mem。如果旧版 Hermes 需要兼容副本，也删除~/.hermes/hermes-agent/plugins/memory/nowledge-mem。 - MCP 模式：从
~/.hermes/config.yaml删除mcp_servers.nowledge-mem配置块。如果你不再需要行为指引，也从~/.hermes/SOUL.md删除以# Nowledge Mem for Hermes开头的那段内容。 - 重启 Hermes，并运行
hermes --version与nmem status，确认 Hermes 和 Mem 客户端仍然正常。
安全地自定义
优先使用 Hermes 自己的指引文件，而不是去改插件安装目录：
~/.hermes/SOUL.md适合放个人默认习惯- 项目根目录的
HERMES.md适合放仓库级规则
不要直接修改 ~/.hermes/plugins/ 下已安装的 Nowledge Mem 插件文件。完整对照表见 安全地自定义集成行为。
常见问题
无法连接 Nowledge Mem。 用 nmem status 确认服务器正在运行，检查地址是否匹配。
Hermes 能检索但从不主动保存持久记忆（MCP 模式）。 行为指引缺失。运行安装命令后重启 Hermes。指引需要在 ~/.hermes/SOUL.md（每次会话都加载）或项目级 HERMES.md（在 git 根目录）中。插件模式下，检索和会话记录捕获都已经内置在提供者生命周期里，不需要额外指引。
Hermes 线程没有出现在 Mem 里。 提供者会在完整轮次结束后同步，并在真实会话边界再做一次刷新。请先完成一轮正常回复，再用正常退出、/new 或 /reset 验证。如果 Hermes 在一轮回复中途被强制杀掉，未完成的那一轮可能来不及进入提供者。
工具未出现（插件模式）。 确认 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