1. 为什么要把 Hermes 和 Obsidian 绑在一起如果你已经按第 05 篇把 Hermes 装起来、能正常对话那接下来最容易踩的坑就是把它当成一个本地版 ChatGPT用。聊几天你会发现它和网页助手最大的区别根本不在对话质量而在于它能把每次任务的产出沉淀成本地文件——技能、记忆、会话纪要全都落在~/.hermes/下面。这些文件如果只是躺在终端里价值其实发挥不出来一旦接进 Obsidian它们就变成了你知识库里可检索、可双向链接、可长期演进的笔记节点。Hermes 是 Nous Research 出的本地优先 Agent 框架跑在 WSL2 里靠config.yaml驱动支持 OpenRouter、DeepSeek、GLM、Kimi 等一堆 provider。Obsidian 则是基于本地 markdown 的双向链接笔记工具。两者结合的核心逻辑很简单Hermes 负责生成与检索Obsidian 负责可视化与组织中间用同一套 markdown 文件打通。适合谁适合已经在用 Obsidian 管知识、又想给 Agent 一个长期记忆 私有上下文的人。如果你只是偶尔问个问题这套组合确实偏重网页助手更省事。这篇我会交付三样东西一份可直接复制的config.yaml骨架、一套 Obsidian 集成的验证步骤、以及我实际用下来总结的优缺点判断。看完你能自己决定要不要长期投入。2. 前置准备TaoToken 与 Hermes 环境在动config.yaml之前先把模型接入这条链路理顺。Hermes 本身不绑定任何一家模型它通过 provider 配置去调外部 API。我日常的做法是编码型任务走 Claude 系通用对话和记忆摘要走 DeepSeek 系而这两类请求我都统一从 TaoToken 这个入口出省得每个 provider 单独配 key、单独管额度。TaoToken 的定位是模型 API 聚合入口官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。它不托管模型只做请求转发所以你在 Hermes 里配的还是一个标准的 OpenAI 兼容端点。对 Hermes 这种模型无关的框架来说这正好合适——你不需要为每个模型改一套接入代码。具体到操作先去控制台建一个 API Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite建完 Key 之后在 Hermes 里配置 provider 时把 base_url 指向https://taotoken.net/api模型名按你实际要用的填。如果你还不确定该选哪个模型可以先去模型对话页试一下模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewriteKey 的管理和轮换在 API Keys 页面API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入细节如果卡住文档里有完整的端点说明接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite环境侧你需要确认三件事Hermes 已装好且能对话第 05 篇的成果、Obsidian 已装且有一个 vault、知道 Hermes 配置在 WSL 下的~/.hermes/config.yaml。这三点齐了就能往下走。3. 可复制的 config.yaml 骨架Hermes 的所有行为几乎都由~/.hermes/config.yaml决定。下面这份是我本地实际在用的骨架你可以直接抄把路径和 key 换成自己的# ~/.hermes/config.yaml provider: name: taotoken base_url: https://taotoken.net/api api_key: sk-你的key model: deepseek/deepseek-v4-pro # 笔记落盘位置指向 Obsidian vault 里的专用文件夹 wiki_path: /mnt/d/你的用户名/obsidian/你的知识库/_wiki memory: memory_enabled: true user_profile_enabled: true write_approval: false # false自动写true写前先问你 memory_char_limit: 2200 user_char_limit: 1375 provider: hindsight nudge_interval: 10 flush_min_turns: 6 tools: enabled: - browser - code - file gateway: enabled: false # 需要手机端接入时再开几个关键点必须说清楚。第一wiki_path是 WSL 路径Windows 的D:\在 WSL 里写作/mnt/d/直接写盘符 Hermes 认不出来会静默失效。第二wiki_path指向的文件夹必须提前手动建好Hermes 不会自动创建目录路径不存在就写不进笔记。第三memory下的子项缩进要比memory:多两格YAML 对缩进严格用空格别用 Tab。改完配置后跑一次诊断确认解析正常hermes doctor如果输出里 provider 和 wiki_path 都显示正常说明骨架没问题。这一步别跳过我见过太多人配置写错缩进结果对话正常但笔记死活不落盘排查半天。4. Obsidian 集成验证四步确认闭环配置改完不代表集成成功得实际验证。我按下面四步走全过才算打通。第一步验证笔记落盘。重启 Hermes随便聊几轮让它产出点内容然后去 Obsidian 里看_wiki文件夹有没有新的.md文件。正常的话文件带 yaml frontmatter长这样--- title: 2026-07-14 Hermes 对话纪要 tags: [hermes, daily] --- ## 今日要点 - 配通了 TaoToken 的 deepseek-v4-pro - 发现聚合入口比逐个 provider 配 key 省事 ## 待跟进 - 下周试 LangGraph第二步验证跨会话记忆。先告诉 Hermes 一条事实比如我们内部 API 用 Bearer Token有效期 2 小时。等几轮对话后开新会话问调我们 API 要注意啥如果它能答出 Token 机制和过期时间说明记忆生效了。记忆文件在~/.hermes/memory/下MEMORY.md存事实USER.md存你的偏好画像。第三步验证 AGENTS.md 上下文加载。在 vault 根目录放一个AGENTS.md写一条你的偏好比如写作风格问题驱动先讲为什么再讲怎么做。新开对话看 Hermes 是否表现出这条偏好。这个文件每次对话自动加载是你把已有知识库喂给 Agent 的入口。第四步验证记忆可视化。建个软链把记忆目录接进 Obsidianln -s ~/.hermes/memory /mnt/d/你的用户名/obsidian/你的知识库/hermes-memory重启 Obsidianhermes-memory文件夹会出现点开就能像普通笔记一样浏览MEMORY.md和USER.md。这一步做完你的知识库和 Agent 记忆就真正合流了。5. 本篇常见错排查集成过程中最容易卡的就那么几个点我按踩坑频率排一下。路径写反。在config.yaml里写D:\你的用户名\...Hermes 跑在 Linux 环境找不到wiki_path静默失效。记住 WSL 里 Windows 盘是/mnt/d/。这个错误最隐蔽因为配置不报错只是笔记不出现。目标文件夹不存在。Hermes 不自动建目录_wiki得先在 Windows 资源管理器里建好再改配置。同理hermes-memory软链的目标目录也要先存在。自动记忆记噪。用久了MEMORY.md会混进过期或错误信息。两个办法把write_approval改成true让它写前问你或者直接在 Obsidian 里打开hermes-memory/MEMORY.md手动删改保存即生效。两边抢改同一文件。Obsidian 和 Hermes 同时改一个 md 会冲突。约定好Hermes 只写_wiki/你手写的笔记放别的文件夹AGENTS.md这种喂给 Agent 的文件由你单方面维护。YAML 缩进错。config.yaml对缩进严格memory:下的子项要多两格。改完跑hermes doctor看配置是否解析正常这是最快的自检手段。软链在 Obsidian 里不显示。ln -s建在 WSL 侧Obsidian 是 Windows 版直接开 vault 根目录一般能看到如果 WSL 终端里ls有但 Obsidian 不显示重启 Obsidian 即可。6. 优缺点判断与下一步把 Hermes 和 Obsidian 打通之后它的真实定位就清楚了这不是替代网页助手的聊天框而是能长期陪你、越用越懂你的本地副驾。优点集中在四点——自进化技能沉淀复杂任务后自动生成 skill 到~/.hermes/skills/下次直接调用、跨会话记忆回溯、模型无关可随时切换、本地优先隐私可控。缺点也实在原生不支持 Windows 必须 WSL2、上手成本明显高于网页助手、自进化偶尔记错记噪、整体偏重型、中文资料少。一句话判断只想偶尔问答网页助手更省事想攒一个随你成长的私有知识层这套组合值得投入。如果你打算长期跑编码和 Agent 任务建议直接上 Coding Plan额度管理更省心Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewriteHermes 属于助手型智能体陪你聊、帮你记。系列里还有执行型的代表比如 OpenClaw小龙虾它不陪你聊直接替你操作文件。下一篇我们把它装起来发一条指令让它真去干活。 
长河君 · 2026/9/28 19:08:23 · 阅读 1.2k AI Agent 开发实战（06）：Hermes 配置与 Obsidian 集成优缺点解析
1. 为什么要把 Hermes 和 Obsidian 绑在一起如果你已经按第 05 篇把 Hermes 装起来、能正常对话那接下来最容易踩的坑就是把它当成一个本地版 ChatGPT用。聊几天你会发现它和网页助手最大的区别根本不在对话质量而在于它能把每次任务的产出沉淀成本地文件——技能、记忆、会话纪要全都落在~/.hermes/下面。这些文件如果只是躺在终端里价值其实发挥不出来一旦接进 Obsidian它们就变成了你知识库里可检索、可双向链接、可长期演进的笔记节点。Hermes 是 Nous Research 出的本地优先 Agent 框架跑在 WSL2 里靠config.yaml驱动支持 OpenRouter、DeepSeek、GLM、Kimi 等一堆 provider。Obsidian 则是基于本地 markdown 的双向链接笔记工具。两者结合的核心逻辑很简单Hermes 负责生成与检索Obsidian 负责可视化与组织中间用同一套 markdown 文件打通。适合谁适合已经在用 Obsidian 管知识、又想给 Agent 一个长期记忆 私有上下文的人。如果你只是偶尔问个问题这套组合确实偏重网页助手更省事。这篇我会交付三样东西一份可直接复制的config.yaml骨架、一套 Obsidian 集成的验证步骤、以及我实际用下来总结的优缺点判断。看完你能自己决定要不要长期投入。2. 前置准备TaoToken 与 Hermes 环境在动config.yaml之前先把模型接入这条链路理顺。Hermes 本身不绑定任何一家模型它通过 provider 配置去调外部 API。我日常的做法是编码型任务走 Claude 系通用对话和记忆摘要走 DeepSeek 系而这两类请求我都统一从 TaoToken 这个入口出省得每个 provider 单独配 key、单独管额度。TaoToken 的定位是模型 API 聚合入口官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。它不托管模型只做请求转发所以你在 Hermes 里配的还是一个标准的 OpenAI 兼容端点。对 Hermes 这种模型无关的框架来说这正好合适——你不需要为每个模型改一套接入代码。具体到操作先去控制台建一个 API Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite建完 Key 之后在 Hermes 里配置 provider 时把 base_url 指向https://taotoken.net/api模型名按你实际要用的填。如果你还不确定该选哪个模型可以先去模型对话页试一下模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewriteKey 的管理和轮换在 API Keys 页面API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入细节如果卡住文档里有完整的端点说明接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite环境侧你需要确认三件事Hermes 已装好且能对话第 05 篇的成果、Obsidian 已装且有一个 vault、知道 Hermes 配置在 WSL 下的~/.hermes/config.yaml。这三点齐了就能往下走。3. 可复制的 config.yaml 骨架Hermes 的所有行为几乎都由~/.hermes/config.yaml决定。下面这份是我本地实际在用的骨架你可以直接抄把路径和 key 换成自己的# ~/.hermes/config.yaml provider: name: taotoken base_url: https://taotoken.net/api api_key: sk-你的key model: deepseek/deepseek-v4-pro # 笔记落盘位置指向 Obsidian vault 里的专用文件夹 wiki_path: /mnt/d/你的用户名/obsidian/你的知识库/_wiki memory: memory_enabled: true user_profile_enabled: true write_approval: false # false自动写true写前先问你 memory_char_limit: 2200 user_char_limit: 1375 provider: hindsight nudge_interval: 10 flush_min_turns: 6 tools: enabled: - browser - code - file gateway: enabled: false # 需要手机端接入时再开几个关键点必须说清楚。第一wiki_path是 WSL 路径Windows 的D:\在 WSL 里写作/mnt/d/直接写盘符 Hermes 认不出来会静默失效。第二wiki_path指向的文件夹必须提前手动建好Hermes 不会自动创建目录路径不存在就写不进笔记。第三memory下的子项缩进要比memory:多两格YAML 对缩进严格用空格别用 Tab。改完配置后跑一次诊断确认解析正常hermes doctor如果输出里 provider 和 wiki_path 都显示正常说明骨架没问题。这一步别跳过我见过太多人配置写错缩进结果对话正常但笔记死活不落盘排查半天。4. Obsidian 集成验证四步确认闭环配置改完不代表集成成功得实际验证。我按下面四步走全过才算打通。第一步验证笔记落盘。重启 Hermes随便聊几轮让它产出点内容然后去 Obsidian 里看_wiki文件夹有没有新的.md文件。正常的话文件带 yaml frontmatter长这样--- title: 2026-07-14 Hermes 对话纪要 tags: [hermes, daily] --- ## 今日要点 - 配通了 TaoToken 的 deepseek-v4-pro - 发现聚合入口比逐个 provider 配 key 省事 ## 待跟进 - 下周试 LangGraph第二步验证跨会话记忆。先告诉 Hermes 一条事实比如我们内部 API 用 Bearer Token有效期 2 小时。等几轮对话后开新会话问调我们 API 要注意啥如果它能答出 Token 机制和过期时间说明记忆生效了。记忆文件在~/.hermes/memory/下MEMORY.md存事实USER.md存你的偏好画像。第三步验证 AGENTS.md 上下文加载。在 vault 根目录放一个AGENTS.md写一条你的偏好比如写作风格问题驱动先讲为什么再讲怎么做。新开对话看 Hermes 是否表现出这条偏好。这个文件每次对话自动加载是你把已有知识库喂给 Agent 的入口。第四步验证记忆可视化。建个软链把记忆目录接进 Obsidianln -s ~/.hermes/memory /mnt/d/你的用户名/obsidian/你的知识库/hermes-memory重启 Obsidianhermes-memory文件夹会出现点开就能像普通笔记一样浏览MEMORY.md和USER.md。这一步做完你的知识库和 Agent 记忆就真正合流了。5. 本篇常见错排查集成过程中最容易卡的就那么几个点我按踩坑频率排一下。路径写反。在config.yaml里写D:\你的用户名\...Hermes 跑在 Linux 环境找不到wiki_path静默失效。记住 WSL 里 Windows 盘是/mnt/d/。这个错误最隐蔽因为配置不报错只是笔记不出现。目标文件夹不存在。Hermes 不自动建目录_wiki得先在 Windows 资源管理器里建好再改配置。同理hermes-memory软链的目标目录也要先存在。自动记忆记噪。用久了MEMORY.md会混进过期或错误信息。两个办法把write_approval改成true让它写前问你或者直接在 Obsidian 里打开hermes-memory/MEMORY.md手动删改保存即生效。两边抢改同一文件。Obsidian 和 Hermes 同时改一个 md 会冲突。约定好Hermes 只写_wiki/你手写的笔记放别的文件夹AGENTS.md这种喂给 Agent 的文件由你单方面维护。YAML 缩进错。config.yaml对缩进严格memory:下的子项要多两格。改完跑hermes doctor看配置是否解析正常这是最快的自检手段。软链在 Obsidian 里不显示。ln -s建在 WSL 侧Obsidian 是 Windows 版直接开 vault 根目录一般能看到如果 WSL 终端里ls有但 Obsidian 不显示重启 Obsidian 即可。6. 优缺点判断与下一步把 Hermes 和 Obsidian 打通之后它的真实定位就清楚了这不是替代网页助手的聊天框而是能长期陪你、越用越懂你的本地副驾。优点集中在四点——自进化技能沉淀复杂任务后自动生成 skill 到~/.hermes/skills/下次直接调用、跨会话记忆回溯、模型无关可随时切换、本地优先隐私可控。缺点也实在原生不支持 Windows 必须 WSL2、上手成本明显高于网页助手、自进化偶尔记错记噪、整体偏重型、中文资料少。一句话判断只想偶尔问答网页助手更省事想攒一个随你成长的私有知识层这套组合值得投入。如果你打算长期跑编码和 Agent 任务建议直接上 Coding Plan额度管理更省心Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewriteHermes 属于助手型智能体陪你聊、帮你记。系列里还有执行型的代表比如 OpenClaw小龙虾它不陪你聊直接替你操作文件。下一篇我们把它装起来发一条指令让它真去干活。