安装与配置：三种方式
07 安装与配置：三种方式
Installation & Configuration
从零到能跑，最快5分钟。这一节覆盖三种安装方式，从本地开发到24/7服务器，选适合你的那个。
方式一：本地安装（5分钟上手）
本地安装最直接，适合先体验再决定要不要长期跑的人。唯一前提是你的机器上有git。
1 运行一键安装脚本
打开终端，粘贴这一行：
curl -fsSL https:#/raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装器会自动处理Python、Node.js和所有依赖。macOS、Linux、WSL2都能跑。
2 配置LLM后端
安装完成后，编辑配置文件：
# 配置⽂件位置
~/.hermes/config.yaml
填入你的模型API Key（后面详细说怎么选模型）。
3 启动Hermes
hermes
没错，就一个词。看到欢迎消息就说明安装成功了。
核心建议
如果你用uv管理Python，也可以通过 uv pip install hermes-agent 安装。效果一样，选你习惯的方式。
方式二：Docker（隔离干净）
不想在本机装一堆依赖？Docker是最干净的选择。
docker pull nousresearch/hermes-agent:latest
docker run -v ~/.hermes:/opt/data nousresearch/hermes-agent:latest
关键参数：-v ~/.hermes:/opt/data 把容器内的数据卷映射到宿主机。Hermes的所有状态（记忆、Skill、配置）都存
在 /opt/data 这一个目录里。容器删了重建，数据不丢。
这个设计挺好。不像有些工具状态散落在各种路径里，Hermes的一切都在 ~/.hermes/ 下面，迁移的时候打包这个目录
就行。
方式三：$5 VPS 24/7运行
如果你想让Hermes随时在线，不依赖你的电脑开着，一台$5/月的VPS就够了。
推荐配置：
VPS提供商 月费 说明
Hetzner CX22 ~$4/月 性价比最高，欧洲节点
DigitalOcean Droplet $5/月 新加坡/美西节点
Vultr $5/月 东京节点延迟低
选Ubuntu 22.04 LTS，SSH登录后跑安装脚本，和本地安装一模一样。不跑本地模型的话，内存占用不到500MB，$5的
机器绑绑有余。
配合Telegram Gateway（§09会讲），手机上随时给Hermes发消息，它就在VPS上响应。一杯咖啡的钱，换一个24小时
在线的AI助手。
Serverless方案：Hermes还支持Daytona和Modal两种serverless后端。空闲时环境休眠，收到消息时自动唤醒，会话间
成本趋近于零。适合用量不大但又想保持可达的场景。在config.yaml里设置 terminal: daytona 或 terminal:
modal 即可。
config.yaml 详解
不管哪种安装方式，核心配置都在一个文件里：~/.hermes/config.yaml。
一个最小可用的配置长这样：
# ~/.hermes/config.yaml
model:
provider: openrouter # 模型提供商
api_key: sk-or-xxxxx # 你的API Key
model: anthropic/claude-sonnet-4 # 使⽤的模型
terminal: local # 终端后端（local/docker/ssh/daytona/modal）
gateway: # 消息⽹关（可选，§09详细讲）
telegram:
token: YOUR_BOT_TOKEN
discord:
token: YOUR_BOT_TOKEN
配置项不多，逐个过一遍。
provider 和 model
Hermes支持的模型来源相当广：
Provider 推荐模型 适用场景
OpenRouter Claude Sonnet 4 / GPT-4o 200+模型可选，灵活切换
Nous Portal Hermes 3系列 官方推荐，和Agent深度适配
OpenAI GPT-4o / o3 直连OpenAI API
z.ai / 智谱 GLM-5 国内用户友好
Ollama Hermes 3 8B/70B 完全离线，隐私优先
注意
注意：2026年4月起，Anthropic封禁了第三方工具通过Claude订阅（Pro/Max）访问Claude。Hermes、OpenClaw等
Agent框架都受影响。你仍然可以通过API key按量付费使用Claude，但成本会高得多。建议优先考虑OpenRouter或
Nous Portal的Hermes 3系列。
我的建议：起步阶段用OpenRouter，可以随时切模型试手感。等确定了常用模型，再直连对应API省中间费用。
terminal
六种后端，决定Hermes在哪里执行代码：
local：直接在本机运行，最简单
docker：容器内运行，隔离安全
ssh：连接远程服务器
daytona / modal：serverless，按需唤醒
singularity：HPC集群环境
大多数人选local就行。如果你担心Agent在本机执行代码的安全性，Docker是个好折中。
常见问题排查
注意
安装脚本卡住？ 检查网络连接。脚本需要从GitHub和PyPI下载依赖。如果在国内，可能需要设置代理或使用镜像源。
注意
hermes命令找不到？ 安装脚本会把命令添加到PATH，但如果你的shell配置比较特殊（比如用了fish），可能需要手动
source ~/.bashrc 或重新打开终端。
核心建议
想确认安装是否成功？ 运行 hermes #-version，看到版本号就对了。当前最新版是v0.7.0。
注意
Docker容器启动后没反应？ 确认 ~/.hermes/config.yaml 已经存在且配置了model信息。容器会读取宿主机映射进来
的配置。如果config.yaml不存在，Hermes会在启动时引导你创建。
核心建议
VPS上的安全提醒：如果在VPS上跑，建议设置 terminal: docker 让代码在容器内执行，避免Agent直接操作宿主机文
件系统。$5的VPS性能足够跑容器。
配置就这些。Hermes的设计思路是能省则省，一个config.yaml搞定所有事，不搞分散的环境变量和多层配置文件。功
能这么丰富的Agent，配置做到这个程度，挺克制的。
下一节直接开聊。Hermes不需要你配完所有东西才能用，装好、填上API Key、启动，就可以开始第一次对话了。
Installation & Configuration
从零到能跑，最快5分钟。这一节覆盖三种安装方式，从本地开发到24/7服务器，选适合你的那个。
方式一：本地安装（5分钟上手）
本地安装最直接，适合先体验再决定要不要长期跑的人。唯一前提是你的机器上有git。
1 运行一键安装脚本
打开终端，粘贴这一行：
curl -fsSL https:#/raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装器会自动处理Python、Node.js和所有依赖。macOS、Linux、WSL2都能跑。
2 配置LLM后端
安装完成后，编辑配置文件：
# 配置⽂件位置
~/.hermes/config.yaml
填入你的模型API Key（后面详细说怎么选模型）。
3 启动Hermes
hermes
没错，就一个词。看到欢迎消息就说明安装成功了。
核心建议
如果你用uv管理Python，也可以通过 uv pip install hermes-agent 安装。效果一样，选你习惯的方式。
方式二：Docker（隔离干净）
不想在本机装一堆依赖？Docker是最干净的选择。
docker pull nousresearch/hermes-agent:latest
docker run -v ~/.hermes:/opt/data nousresearch/hermes-agent:latest
关键参数：-v ~/.hermes:/opt/data 把容器内的数据卷映射到宿主机。Hermes的所有状态（记忆、Skill、配置）都存
在 /opt/data 这一个目录里。容器删了重建，数据不丢。
这个设计挺好。不像有些工具状态散落在各种路径里，Hermes的一切都在 ~/.hermes/ 下面，迁移的时候打包这个目录
就行。
方式三：$5 VPS 24/7运行
如果你想让Hermes随时在线，不依赖你的电脑开着，一台$5/月的VPS就够了。
推荐配置：
VPS提供商 月费 说明
Hetzner CX22 ~$4/月 性价比最高，欧洲节点
DigitalOcean Droplet $5/月 新加坡/美西节点
Vultr $5/月 东京节点延迟低
选Ubuntu 22.04 LTS，SSH登录后跑安装脚本，和本地安装一模一样。不跑本地模型的话，内存占用不到500MB，$5的
机器绑绑有余。
配合Telegram Gateway（§09会讲），手机上随时给Hermes发消息，它就在VPS上响应。一杯咖啡的钱，换一个24小时
在线的AI助手。
Serverless方案：Hermes还支持Daytona和Modal两种serverless后端。空闲时环境休眠，收到消息时自动唤醒，会话间
成本趋近于零。适合用量不大但又想保持可达的场景。在config.yaml里设置 terminal: daytona 或 terminal:
modal 即可。
config.yaml 详解
不管哪种安装方式，核心配置都在一个文件里：~/.hermes/config.yaml。
一个最小可用的配置长这样：
# ~/.hermes/config.yaml
model:
provider: openrouter # 模型提供商
api_key: sk-or-xxxxx # 你的API Key
model: anthropic/claude-sonnet-4 # 使⽤的模型
terminal: local # 终端后端（local/docker/ssh/daytona/modal）
gateway: # 消息⽹关（可选，§09详细讲）
telegram:
token: YOUR_BOT_TOKEN
discord:
token: YOUR_BOT_TOKEN
配置项不多，逐个过一遍。
provider 和 model
Hermes支持的模型来源相当广：
Provider 推荐模型 适用场景
OpenRouter Claude Sonnet 4 / GPT-4o 200+模型可选，灵活切换
Nous Portal Hermes 3系列 官方推荐，和Agent深度适配
OpenAI GPT-4o / o3 直连OpenAI API
z.ai / 智谱 GLM-5 国内用户友好
Ollama Hermes 3 8B/70B 完全离线，隐私优先
注意
注意：2026年4月起，Anthropic封禁了第三方工具通过Claude订阅（Pro/Max）访问Claude。Hermes、OpenClaw等
Agent框架都受影响。你仍然可以通过API key按量付费使用Claude，但成本会高得多。建议优先考虑OpenRouter或
Nous Portal的Hermes 3系列。
我的建议：起步阶段用OpenRouter，可以随时切模型试手感。等确定了常用模型，再直连对应API省中间费用。
terminal
六种后端，决定Hermes在哪里执行代码：
local：直接在本机运行，最简单
docker：容器内运行，隔离安全
ssh：连接远程服务器
daytona / modal：serverless，按需唤醒
singularity：HPC集群环境
大多数人选local就行。如果你担心Agent在本机执行代码的安全性，Docker是个好折中。
常见问题排查
注意
安装脚本卡住？ 检查网络连接。脚本需要从GitHub和PyPI下载依赖。如果在国内，可能需要设置代理或使用镜像源。
注意
hermes命令找不到？ 安装脚本会把命令添加到PATH，但如果你的shell配置比较特殊（比如用了fish），可能需要手动
source ~/.bashrc 或重新打开终端。
核心建议
想确认安装是否成功？ 运行 hermes #-version，看到版本号就对了。当前最新版是v0.7.0。
注意
Docker容器启动后没反应？ 确认 ~/.hermes/config.yaml 已经存在且配置了model信息。容器会读取宿主机映射进来
的配置。如果config.yaml不存在，Hermes会在启动时引导你创建。
核心建议
VPS上的安全提醒：如果在VPS上跑，建议设置 terminal: docker 让代码在容器内执行，避免Agent直接操作宿主机文
件系统。$5的VPS性能足够跑容器。
配置就这些。Hermes的设计思路是能省则省，一个config.yaml搞定所有事，不搞分散的环境变量和多层配置文件。功
能这么丰富的Agent，配置做到这个程度，挺克制的。
下一节直接开聊。Hermes不需要你配完所有东西才能用，装好、填上API Key、启动，就可以开始第一次对话了。