基于腾讯云轻量服务器的 Hermes 镜像 5 分钟接入 Obsidian 内容中台

基于腾讯云轻量服务器的 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。

文章导读

先看一张主线图,后面的步骤就好理解了。

Hermes Agent 接入 Obsidian 内容中台流程图

这里的核心不是“装一个工具”,而是把服务器、Agent 和 Markdown Vault 这三件事串起来。

服务器负责稳定运行,Hermes 负责执行,Obsidian Vault 负责沉淀过程和结果。先把这条链跑通,后面再接更多输入源才有意义。

1. 本次环境:腾讯云轻量服务器 Hermes Agent 镜像

这次我使用的是腾讯云轻量应用服务器里的 Hermes Agent 应用模板,也可以理解成已经预装好 Hermes 的自定义镜像。

所以这篇不写普通系统镜像的安装流程,也不写 curl install.sh 从零安装 Hermes。因为如果已经选择了 Hermes Agent 镜像,这些步骤就不需要重复做。

在腾讯云轻量服务器控制台里,如果当前服务器不是 Hermes Agent 镜像,可以选择重装系统。

腾讯云轻量服务器重装系统入口

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

腾讯云轻量服务器选择 Hermes Agent 应用模板

这里要提醒一句:重装系统会清空服务器上的数据。如果服务器里已经有资料、配置、数据库或者其他服务,先备份,再重装。不要为了省几分钟,把已有资料直接覆盖掉。

重装完成后,先登录服务器:

1
ssh ubuntu@你的服务器公网IP

然后检查 Hermes 是否已经可用:

1
hermes --version

我这里看到的版本信息类似这样:

1
2
3
4
Hermes Agent v0.16.0 (2026.6.5)
Project: /home/ubuntu/.hermes/hermes-agent
Python: 3.11.15
OpenAI SDK: 2.24.0

这里即使提示 Update available,这次也先不更新。

原因很简单:我们当前目标是跑通内容中台最小流程,不是追最新版本。更新过程时间比较久,中间还可能遇到网络、依赖、交互确认等问题,容易把主线带偏。先用镜像里已经预装好的 Hermes 跑通流程,后面真正稳定使用时,再单独安排更新时间。

2. 运行 Hermes 初始化配置

确认 hermes --version 能正常输出以后,开始初始化配置:

1
hermes setup

下面几个界面是关键,尤其是模型供应商、API 兼容模式和本机执行方式。

3. 模型供应商:中转站网关选 Custom endpoint

我的环境使用的是中转站网关,不是直接使用官方 OpenAI Key。

很多中转站都会兼容 OpenAI 协议,这种情况下不要选官方 OpenAI,而是选择:

1
Custom endpoint (enter URL manually)

Hermes 选择 Custom endpoint

一般按下面这个思路填写:

1
2
3
4
5
API base URL: https://你的中转站域名/v1
API key: 你的中转站 key
API type / protocol: OpenAI compatible
Mode: Chat Completions
Model name: 中转站后台实际支持的模型名

这里最容易出错的是模型名。

不要凭感觉写 gpt-4、claude 这类名字,要去中转站后台看它实际支持的模型 ID。后台显示什么,这里就填什么。

4. API compatibility mode:选 Chat Completions

普通 OpenAI-compatible 中转站,一般走的是:

1
/v1/chat/completions

所以这里选择:

1
2. Chat Completions

Hermes API compatibility mode 选择 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 Terminal backend 选择 Local

原因很直接:我们就是要让 Hermes 在这台腾讯云轻量服务器上运行,并读写服务器本地的 Obsidian Vault 目录。

当前不需要 Docker、SSH、Modal、Daytona 这些执行后端。先把本机执行跑通,问题最少。

6. Messaging platforms:全部跳过

这个页面会让你选择 Telegram、Slack、飞书、微信、Discord 等消息平台。

Hermes 消息平台全部跳过

这次目标只是让 Hermes 管理 Obsidian 内容中台,所以这里全部不选,直接按:

1
Enter

消息入口以后可以再接,现在先不要增加变量。

7. CLI Tools:保留内容处理需要的工具

这个页面决定 Hermes CLI 可以使用哪些工具。

Hermes CLI tools 选择

做 Obsidian 内容中台实验,至少保留这些:

1
2
3
4
5
6
7
8
9
File Operations
Terminal & Processes
Code Execution
Skills
Task Planning
Memory
Session Search
Clarifying Questions
Cron Jobs

建议也保留:

1
2
Web Search & Scraping
Browser Automation

因为后面 Hermes 可能需要读取网页、抓取资料、整理 Source Note。

第一轮可以先取消这些:

1
2
3
4
5
6
7
8
9
10
11
Image Generation
Text-to-Speech
Cross-Platform Messaging
Computer Use (macOS)
Video Analysis
Video Generation
X Search
Mixture of Agents
Home Assistant
Spotify
Yuanbao

这里的原则是:先让文字处理链路跑通。工具越少,排查问题越简单。

8. Browser provider:选 Local Browser

浏览器提供方选择:

1
Local Browser [recommended - free]

Hermes Browser provider 选择 Local Browser

这会使用服务器本地的无头 Chromium,不需要额外 API Key。用来抓网页、读链接内容已经够了。

如果后面提示缺浏览器依赖,先按 Hermes 或 Playwright 给出的提示处理,不要一开始就把这块复杂化。

9. Image Generation:先 Skip

图片生成服务暂时用不到,选择:

1
Skip - keep defaults / configure later

Hermes Image Generation 先跳过

这里不要急着接图像模型。内容中台第一步是资料筛选、选题拆解和草稿生成,不是生成封面图。

10. TTS Provider:先 Skip

TTS 是文本转语音,也不是当前实验的重点。选择:

1
Skip - keep defaults / configure later

Hermes TTS Provider 先跳过

如果保留默认的 Microsoft Edge TTS 也可以,但为了配置干净,我这里建议先跳过。

11. Search Provider:选 DuckDuckGo

搜索提供方建议选择:

1
DuckDuckGo (ddgs)

Hermes Search Provider 选择 DuckDuckGo

原因是它免费、无 Key,适合先做实验。

Firecrawl、Exa、Tavily 这类能力以后再看,先不要把所有服务都接上来。

12. Setup Complete

看到这个页面,说明基础配置完成。

Hermes Setup Complete

配置文件位置一般是:

1
2
3
Settings: /home/ubuntu/.hermes/config.yaml
API Keys: /home/ubuntu/.hermes/.env
Data: /home/ubuntu/.hermes/cron/, sessions/, logs/

可以先跑两个检查:

1
2
hermes doctor
hermes config

如果这里没有明显报错,就进入 Obsidian Vault 配置。

13. 创建 Obsidian 内容中台目录

服务器上不需要安装 Obsidian 桌面客户端。

Obsidian 的 Vault 本质就是一个 Markdown 文件夹。Hermes 只要能读写这个目录,就可以把它当成内容中台的工作区。

创建目录:

1
2
3
4
5
mkdir -p ~/obsidian-content-vault/01-Sources/Inbox
mkdir -p ~/obsidian-content-vault/02-Accounts/WeiWill/Topics
mkdir -p ~/obsidian-content-vault/02-Accounts/WeiWill/Drafts
mkdir -p ~/obsidian-content-vault/02-Accounts/WeiWill/Published
mkdir -p ~/obsidian-content-vault/03-Frameworks

目录结构是:

1
2
3
4
5
6
7
8
9
obsidian-content-vault/
├── 01-Sources/
│ └── Inbox/
├── 02-Accounts/
│ └── WeiWill/
│ ├── Topics/
│ ├── Drafts/
│ └── Published/
└── 03-Frameworks/

先不要设计太多目录。最小链路就是:

1
Source Note -> Topic Note -> Draft Note -> Published Note

14. 写入 Vault 路径

把 Vault 路径写到 Hermes 的 .env:

1
2
grep -q '^OBSIDIAN_VAULT_PATH=' ~/.hermes/.env 2>/dev/null || \
echo 'OBSIDIAN_VAULT_PATH=/home/ubuntu/obsidian-content-vault' >> ~/.hermes/.env

如果你的用户名不是 ubuntu,把路径改成实际用户目录。

检查:

1
grep '^OBSIDIAN_VAULT_PATH=' ~/.hermes/.env

应该看到:

1
OBSIDIAN_VAULT_PATH=/home/ubuntu/obsidian-content-vault

15. 创建账号定位文件

为了让 Hermes 知道账号写什么,可以先放一个账号定位文件,这里是写的我的账号,如果有自己的账号或者有更优的目录结构,这里都是灵活的。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
cat > ~/obsidian-content-vault/03-Frameworks/WeiWill-账号定位.md <<'EOF'
# WeiWill 账号定位

主题:智能编程、Agent 工作流、Hermes/Cursor/Claude Code 实战、技术管理者提效。

选题标准:
- 有明确用户痛点
- 有真实使用场景
- 能沉淀成可复现工作流
- 少讲概念,多讲步骤、取舍和踩坑

表达风格:
- 干货、直接、具体
- 不写成工具说明书
- 每篇文章要有自己的判断
EOF

这个文件后面会成为 Hermes 判断选题和写草稿时的重要上下文。

其实这一步很关键。Agent 不怕没有能力,怕的是不知道你的账号边界、内容标准和表达风格。先把账号定位写清楚,后面生成的内容才不容易跑偏。

16. 第一次测试 Hermes 写入 Vault

启动 Hermes:

1
hermes

然后输入:

1
2
3
4
5
6
7
8
9
使用 Obsidian vault:/home/ubuntu/obsidian-content-vault。

请创建一个测试 Source Note,保存到 01-Sources/Inbox。
主题:Hermes + Obsidian 内容中台实验。
内容包括:
- 核心摘要
- 适合账号:WeiWill
- 可拆选题 3 个
- 下一步建议

退出 Hermes 后,检查有没有生成 Markdown 文件:

1
find ~/obsidian-content-vault -type f -name "*.md" -print

如果能看到 .md 文件,说明服务器侧 Hermes 已经能写入 Obsidian Vault。到这里,最小闭环就跑通了。

总结

这次搭建的核心,不是把 Hermes 装起来就结束了,而是把它放到内容生产流程里,当作内容中台的执行器。

最小版本只做三件事:

1
2
3
1. 使用腾讯云轻量服务器 Hermes Agent 镜像
2. 配好中转站 OpenAI-compatible 模型
3. 创建 Obsidian Vault,并验证 Hermes 能写入 Source Note

到这里,这篇手册就先收住。下一步不是马上堆更多工具,而是拿一篇真实材料,让 Hermes 真的写进 Source Note,再看它能不能稳定推进到 Topic 和 Draft。
其实服务器上并没有体现Obsidian软件,只是一个目录结构,具体的Obsidian能干什么,我后面的文章进行介绍。

工具跑起来只是开始,能反复执行,才算真正进入内容中台。

我是 WeiWill,专注 AI 应用落地与 Agent 开发,关注我,一起成长。