基于腾讯云轻量服务器的 Hermes 镜像 5 分钟接入 Obsidian 内容中台
我这次安装和配置 Hermes,不是为了单独体验一个 Agent 工具,而是为了搭一个内容中台的执行层。
内容中台里,Obsidian Vault 更像一个开放的 Markdown 工作区。
这里先解释一下 Vault。Obsidian 里所谓的 Vault,本质上就是一个文件夹,里面放的是一批 Markdown 文件。你可以用 Obsidian 打开它、浏览它、建立双链和图谱;也可以不用 Obsidian 桌面软件,直接让其他程序读写这个文件夹。
所以在这套方案里,Vault 负责保存资料、选题、草稿和发布记录;Hermes Agent 要承担的是执行器角色,负责读取资料、筛选内容、拆选题、生成草稿,并把结果写回 Vault。服务器和我本地之间,我使用 Git 做同步。
为什么选择把 Hermes 装在服务器上,而不是只放在本地电脑上?核心有三个考虑。
第一,服务器可以长期在线。内容中台不是一次性写一篇文章,而是后面要持续处理资料、执行任务、沉淀结果。放在服务器上,流程更容易保持稳定。
第二,服务器和本地电脑可以做权限隔离。本地电脑里有太多个人文件和临时资料,把执行环境放到服务器上,目录边界更清楚,风险也更容易控制。
第三,成本可接受。腾讯云轻量服务器这类机器价格不高,像 99 元一年的配置,用来跑通 Hermes + Obsidian Vault 的最小流程已经够用。先用低成本方案把闭环跑起来,比一开始就堆复杂环境更现实。
先把目标说清楚。这篇只做一个最小闭环:
1 | 服务器预装 Hermes -> 配置中转站模型 -> 创建 Obsidian Vault -> Hermes 写入 Source Note |
本次只验证:服务器上的 Hermes 能不能正常跑起来,并且能不能写入一个 Markdown Vault。
文章导读
先看一张主线图,后面的步骤就好理解了。

这里的核心不是“装一个工具”,而是把服务器、Agent 和 Markdown Vault 这三件事串起来。
服务器负责稳定运行,Hermes 负责执行,Obsidian Vault 负责沉淀过程和结果。先把这条链跑通,后面再接更多输入源才有意义。
1. 本次环境:腾讯云轻量服务器 Hermes Agent 镜像
这次我使用的是腾讯云轻量应用服务器里的 Hermes Agent 应用模板,也可以理解成已经预装好 Hermes 的自定义镜像。
所以这篇不写普通系统镜像的安装流程,也不写 curl install.sh 从零安装 Hermes。因为如果已经选择了 Hermes Agent 镜像,这些步骤就不需要重复做。
在腾讯云轻量服务器控制台里,如果当前服务器不是 Hermes Agent 镜像,可以选择重装系统。

重装时选择应用模板里的 Hermes Agent。

这里要提醒一句:重装系统会清空服务器上的数据。如果服务器里已经有资料、配置、数据库或者其他服务,先备份,再重装。不要为了省几分钟,把已有资料直接覆盖掉。
重装完成后,先登录服务器:
1 | ssh ubuntu@你的服务器公网IP |
然后检查 Hermes 是否已经可用:
1 | hermes --version |
我这里看到的版本信息类似这样:
1 | Hermes Agent v0.16.0 (2026.6.5) |
这里即使提示 Update available,这次也先不更新。
原因很简单:我们当前目标是跑通内容中台最小流程,不是追最新版本。更新过程时间比较久,中间还可能遇到网络、依赖、交互确认等问题,容易把主线带偏。先用镜像里已经预装好的 Hermes 跑通流程,后面真正稳定使用时,再单独安排更新时间。
2. 运行 Hermes 初始化配置
确认 hermes --version 能正常输出以后,开始初始化配置:
1 | hermes setup |
下面几个界面是关键,尤其是模型供应商、API 兼容模式和本机执行方式。
3. 模型供应商:中转站网关选 Custom endpoint
我的环境使用的是中转站网关,不是直接使用官方 OpenAI Key。
很多中转站都会兼容 OpenAI 协议,这种情况下不要选官方 OpenAI,而是选择:
1 | Custom endpoint (enter URL manually) |

一般按下面这个思路填写:
1 | API base URL: https://你的中转站域名/v1 |
这里最容易出错的是模型名。
不要凭感觉写 gpt-4、claude 这类名字,要去中转站后台看它实际支持的模型 ID。后台显示什么,这里就填什么。
4. API compatibility mode:选 Chat Completions
普通 OpenAI-compatible 中转站,一般走的是:
1 | /v1/chat/completions |
所以这里选择:
1 | 2. Chat Completions |

简单判断:
| 场景 | 选择 |
|---|---|
| 普通 OpenAI-compatible 中转站 | 2. Chat Completions |
| 中转站明确支持 Responses API | 按中转站说明选择 Responses |
| 不确定 | 先选 Chat Completions,跑通以后再调整 |
这点很重要。很多问题不是 Key 错了,而是 endpoint 和协议模式选错了。
5. Terminal backend:选 Local
这里选择:
1 | Local - run directly on this machine |

原因很直接:我们就是要让 Hermes 在这台腾讯云轻量服务器上运行,并读写服务器本地的 Obsidian Vault 目录。
当前不需要 Docker、SSH、Modal、Daytona 这些执行后端。先把本机执行跑通,问题最少。
6. Messaging platforms:全部跳过
这个页面会让你选择 Telegram、Slack、飞书、微信、Discord 等消息平台。

这次目标只是让 Hermes 管理 Obsidian 内容中台,所以这里全部不选,直接按:
1 | Enter |
消息入口以后可以再接,现在先不要增加变量。
7. CLI Tools:保留内容处理需要的工具
这个页面决定 Hermes CLI 可以使用哪些工具。

做 Obsidian 内容中台实验,至少保留这些:
1 | File Operations |
建议也保留:
1 | Web Search & Scraping |
因为后面 Hermes 可能需要读取网页、抓取资料、整理 Source Note。
第一轮可以先取消这些:
1 | Image Generation |
这里的原则是:先让文字处理链路跑通。工具越少,排查问题越简单。
8. Browser provider:选 Local Browser
浏览器提供方选择:
1 | Local Browser [recommended - free] |

这会使用服务器本地的无头 Chromium,不需要额外 API Key。用来抓网页、读链接内容已经够了。
如果后面提示缺浏览器依赖,先按 Hermes 或 Playwright 给出的提示处理,不要一开始就把这块复杂化。
9. Image Generation:先 Skip
图片生成服务暂时用不到,选择:
1 | Skip - keep defaults / configure later |

这里不要急着接图像模型。内容中台第一步是资料筛选、选题拆解和草稿生成,不是生成封面图。
10. TTS Provider:先 Skip
TTS 是文本转语音,也不是当前实验的重点。选择:
1 | Skip - keep defaults / configure later |

如果保留默认的 Microsoft Edge TTS 也可以,但为了配置干净,我这里建议先跳过。
11. Search Provider:选 DuckDuckGo
搜索提供方建议选择:
1 | DuckDuckGo (ddgs) |

原因是它免费、无 Key,适合先做实验。
Firecrawl、Exa、Tavily 这类能力以后再看,先不要把所有服务都接上来。
12. Setup Complete
看到这个页面,说明基础配置完成。

配置文件位置一般是:
1 | Settings: /home/ubuntu/.hermes/config.yaml |
可以先跑两个检查:
1 | hermes doctor |
如果这里没有明显报错,就进入 Obsidian Vault 配置。
13. 创建 Obsidian 内容中台目录
服务器上不需要安装 Obsidian 桌面客户端。
Obsidian 的 Vault 本质就是一个 Markdown 文件夹。Hermes 只要能读写这个目录,就可以把它当成内容中台的工作区。
创建目录:
1 | mkdir -p ~/obsidian-content-vault/01-Sources/Inbox |
目录结构是:
1 | obsidian-content-vault/ |
先不要设计太多目录。最小链路就是:
1 | Source Note -> Topic Note -> Draft Note -> Published Note |
14. 写入 Vault 路径
把 Vault 路径写到 Hermes 的 .env:
1 | grep -q '^OBSIDIAN_VAULT_PATH=' ~/.hermes/.env 2>/dev/null || \ |
如果你的用户名不是 ubuntu,把路径改成实际用户目录。
检查:
1 | grep '^OBSIDIAN_VAULT_PATH=' ~/.hermes/.env |
应该看到:
1 | OBSIDIAN_VAULT_PATH=/home/ubuntu/obsidian-content-vault |
15. 创建账号定位文件
为了让 Hermes 知道账号写什么,可以先放一个账号定位文件,这里是写的我的账号,如果有自己的账号或者有更优的目录结构,这里都是灵活的。
1 | cat > ~/obsidian-content-vault/03-Frameworks/WeiWill-账号定位.md <<'EOF' |
这个文件后面会成为 Hermes 判断选题和写草稿时的重要上下文。
其实这一步很关键。Agent 不怕没有能力,怕的是不知道你的账号边界、内容标准和表达风格。先把账号定位写清楚,后面生成的内容才不容易跑偏。
16. 第一次测试 Hermes 写入 Vault
启动 Hermes:
1 | hermes |
然后输入:
1 | 使用 Obsidian vault:/home/ubuntu/obsidian-content-vault。 |
退出 Hermes 后,检查有没有生成 Markdown 文件:
1 | find ~/obsidian-content-vault -type f -name "*.md" -print |
如果能看到 .md 文件,说明服务器侧 Hermes 已经能写入 Obsidian Vault。到这里,最小闭环就跑通了。
总结
这次搭建的核心,不是把 Hermes 装起来就结束了,而是把它放到内容生产流程里,当作内容中台的执行器。
最小版本只做三件事:
1 | 1. 使用腾讯云轻量服务器 Hermes Agent 镜像 |
到这里,这篇手册就先收住。下一步不是马上堆更多工具,而是拿一篇真实材料,让 Hermes 真的写进 Source Note,再看它能不能稳定推进到 Topic 和 Draft。
其实服务器上并没有体现Obsidian软件,只是一个目录结构,具体的Obsidian能干什么,我后面的文章进行介绍。
工具跑起来只是开始,能反复执行,才算真正进入内容中台。
我是 WeiWill,专注 AI 应用落地与 Agent 开发,关注我,一起成长。