企业官网建设流程全解析

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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 端点是 https://taotoken.net/api 。它不托管模型，只做请求转发，所以你在 Hermes 里配的还是一个标准的 OpenAI 兼容端点。对 Hermes 这种"模型无关"的框架来说，这正好合适——你不需要为每个模型改一套接入代码。

具体到操作，先去控制台建一个 API Key：

控制台入口：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite

建完 Key 之后，在 Hermes 里配置 provider 时，把 base_url 指向https://taotoken.net/api，模型名按你实际要用的填。如果你还不确定该选哪个模型，可以先去模型对话页试一下：

模型对话：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite

Key 的管理和轮换在 API Keys 页面：

API Keys：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite

接入细节如果卡住，文档里有完整的端点说明：

接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

环境侧你需要确认三件事：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 的入口。

第四步，验证记忆可视化。建个软链把记忆目录接进 Obsidian：

ln -s ~/.hermes/memory /mnt/d/你的用户名/obsidian/你的知识库/hermes-memory

重启 Obsidian，hermes-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 Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite

Hermes 属于"助手型"智能体，陪你聊、帮你记。系列里还有执行型的代表，比如 OpenClaw（小龙虾），它不陪你聊，直接替你操作文件。下一篇我们把它装起来，发一条指令让它真去干活。