Hermes Agent 支持多种运行环境，不同场景有不同的最优安装方式。这篇文章把六种路径全部讲清楚，帮你根据自己的情况选对方案。
安装路径速览
| 方式 | 难度 | 24/7 | 本地文件 | 月费 | 推荐场景 |
|---|---|---|---|---|---|
| VPS | ⭐⭐ | ✅ | ❌ | ¥35+ | 大多数人的首选 |
| Mac 本地 | ⭐ | 需开机 | ✅ | 电费 | 开发者、有 Mac Mini |
| WSL2 | ⭐⭐ | 需开机 | ✅ | 电费 | Windows 用户 |
| Docker | ⭐⭐ | ✅ | ✅ | ¥35+ | 需要隔离 |
| Pinokio | ⭐ | 需开机 | ✅ | 免费 | 零命令行体验 |
| Serverless（Modal/Daytona） | ⭐⭐⭐ | ✅（按需唤醒） | ❌ | 按量 | 成本极致优化 |
路径 1：VPS 部署（推荐大多数人）
优点：24/7 在线、不需要本地电脑一直开着、稳定 推荐 VPS：Hetzner（德国，性价比高）、DigitalOcean、Contabo
# SSH 登录服务器
ssh root@your-server-ip
# 一键安装（自动处理 Python、Node.js、所有依赖）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# 安装完成后重载 shell
source ~/.bashrc # 或 source ~/.zshrc
# 运行安装向导（选择 LLM 提供商，配置 API Key）
hermes setup
# 启动测试
hermes
# 配置 Telegram 网关
hermes gateway setup
# 安装为系统服务（开机自启）
hermes gateway install最低配置：2 核 2GB（Hetzner CX21，约 ¥35/月）够用。不需要运行本地 LLM 的话，Hermes 本身很轻量。
路径 2：Mac 本地安装
优点：访问本地文件方便、可以跑本地 Ollama 模型 推荐：Mac Mini M4（16GB 起），专用机 24/7 运行
# 同样一键安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
# 运行安装向导
hermes setup
# 如果想跑本地模型，先安装 Ollama
brew install ollama
ollama pull llama3.3 # 8GB 以上统一内存
# 然后在 hermes setup 里选 Custom Endpoint
# 需要 24/7 在线：安装 Amphetamine（Mac App Store），禁止 Mac 进入睡眠
# 然后注册为系统服务
hermes gateway installMac Mini M4 推荐配置：
| 型号 | 统一内存 | 能跑的本地模型 | 价格 |
|---|---|---|---|
| Mac Mini M4 | 16GB | llama3.3、qwen2.5-coder:14b | ¥4,000 |
| Mac Mini M4 Pro | 24GB | qwen2.5-coder:32b | ¥6,000 |
路径 3：Windows WSL2
Windows 不原生支持，但 WSL2 完全可用。
# PowerShell（管理员身份运行）
wsl --install
# 重启电脑后进入 Ubuntu# 进入 WSL2 Ubuntu 后，和 Linux 安装方式完全一样
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup
hermesWSL2 的限制：
- 关闭 Windows 或 WSL2 就关闭了 Agent
- 文件系统访问 Windows 文件需要通过
/mnt/c/...路径 - 网关需要 WSL2 的网络端口穿透才能外网访问
路径 4：Docker 容器
提供环境隔离，适合不想污染主机的场景。
# CLI 交互模式
docker run -it nousresearch/hermes-agent
# 消息网关守护进程（推荐生产用法）
docker run -d --name hermes-gateway --restart unless-stopped -e OPENROUTER_API_KEY=sk-or-xxx -e TELEGRAM_BOT_TOKEN=xxx nousresearch/hermes-agent gateway
# 持久化数据（技能、记忆）
docker run -d --name hermes-gateway --restart unless-stopped -v hermes-data:/root/.hermes -e OPENROUTER_API_KEY=sk-or-xxx nousresearch/hermes-agent gatewayDocker Compose 方式（推荐生产）：
version: "3.8"
services:
hermes:
image: nousresearch/hermes-agent
command: gateway
restart: unless-stopped
volumes:
- hermes-data:/root/.hermes
environment:
- OPENROUTER_API_KEY=sk-or-xxx
- TELEGRAM_BOT_TOKEN=xxx
volumes:
hermes-data:docker compose up -d
docker compose logs -f hermes路径 5：Pinokio 一键安装（零命令行）
Pinokio 是 AI 工具的图形化安装平台，类似 App Store。完全不需要打命令行。
- 下载 Pinokio（pinokio.computer）
- 在 Pinokio 里搜索「Hermes Agent」
- 点「Install」
- 安装完成后点「Launch」
适合：完全不熟悉命令行的用户。 限制：功能定制性差，更新依赖 Pinokio 更新 recipe，高级配置仍需要手动操作。
路径 6：Serverless（Modal / Daytona）
空闲时休眠、有任务时唤醒。成本极致优化，适合不需要 24/7 在线的场景。
Modal
# 安装 modal
pip install modal
# 配置 Hermes 使用 Modal 后端
hermes config set terminal.backend modal
# 启动时自动在 Modal 上创建计算环境
hermesModal 按实际 GPU/CPU 使用时间计费，空闲时几乎不产生费用。
Daytona
hermes config set terminal.backend daytonaDaytona 提供持久化的开发容器，空闲时挂起，有任务时自动唤醒。
Serverless 的权衡：
- 唤醒需要 10-30 秒冷启动时间
- 无法访问本地文件系统
- 适合计算密集型任务（LLM 推理、数据处理）
从 OpenClaw 迁移到 Hermes？
安装向导会自动检测 OpenClaw 的配置：
hermes setup
# 向导会问「是否从 OpenClaw 迁移？」
# 选是，自动导入 API Key 和部分设置可以迁移的：LLM 提供商配置、API Key、部分工具设置 需要手动重建的：Skills（格式不完全一样）、SOUL.md/MEMORY.md 内容（手动复制到 MEMORY.md 和 USER.md）
两者 Skill 文件格式大体兼容，OpenClaw 的 SKILL.md 可以直接复制到 ~/.hermes/skills/ 目录下使用。
常见安装问题
hermes: command not found
source ~/.zshrc # 或 ~/.bashrc
# 还不行：export PATH=~/.hermes/bin:~/.local/bin:<existing-PATH>安装时报 Permission denied
chmod +x install.sh
bash install.sh # 不要 sudo国内网络下载慢
HTTPS_PROXY=http://127.0.0.1:7890 curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装完成后运行 hermes doctor 诊断所有配置问题。
来源：virtualuncle.com 完整指南 | aarongxa.com 实战指南 | 整理：ClaudeEagle