跳转到主要内容
HermesAgent.Work
Install commands

Hermes Agent 安装命令补充

本页补充 Windows WSL2、Windows PowerShell Early Beta、macOS、Linux 和 VPS 的具体命令。完整安装主线请先看 /hermes-agent-install。

安装主线

先看安装部署专题，再按系统执行命令

如果你是第一次部署 Hermes Agent，建议先从安装部署专题理解 Provider、setup 验收、VPS 和长期运行边界。本页保留 Windows、Linux、macOS 的具体命令和检查项。

打开 Hermes Agent 安装部署主线

前置条件

  • ✓ Git / Node.js / Python 可用
  • ✓ 模型 API Key 已准备
  • ✓ 终端能读取环境变量
  • ✓ 日志目录可写
  • ✓ Windows 优先使用 WSL2

Platform install

Windows、Linux、macOS 怎么选

新手不要先纠结所有安装方式。按系统选一条主线，安装后统一用 setup、doctor、model 和 skills 命令验收。

阅读安装补充

Windows 推荐：WSL2

官方支持

Windows 上最稳的路线仍是 WSL2。先用 PowerShell 启用 WSL2，再在 Ubuntu 终端里按 Linux 方式安装 Hermes Agent。

wsl --install
wsl --set-default-version 2

# 打开 Ubuntu 终端后执行
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup
  • ✓ Windows 和 WSL2 的配置目录不同，不要混用。
  • ✓ 路径、shell、工具调用和日志行为更接近 Linux/macOS。

Windows 原生 PowerShell

Early Beta

官方已经提供原生 PowerShell 安装路线，但仍是 Early Beta。适合想快速体验 CLI 的用户；长期稳定使用仍优先 WSL2。

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

# 安装后新开一个 PowerShell
hermes setup
hermes doctor
  • ✓ 安装后必须新开终端，让 PATH 生效。
  • ✓ 如果遇到终端、编码或工具调用问题，优先切回 WSL2。

macOS

推荐

适合 Mac 用户本地上手。先确认 Git 可用，再运行一键脚本；如果命令找不到，重新加载 zsh 配置。

git --version
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
hermes setup
  • ✓ 默认终端通常是 zsh，所以优先检查 ~/.zshrc。
  • ✓ 第一次先跑 CLI，不急着接消息平台。

Linux / VPS

长期运行

适合 Linux 桌面、Ubuntu/Debian VPS 和团队部署。个人上手用普通用户，长期运行再补低权限用户、日志和进程守护。

sudo apt update
sudo apt install -y git curl
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup
  • ✓ VPS 不建议长期用 root 跑工作流。
  • ✓ 上线前必须补日志、重启策略和人工确认边界。

1. 先装到本地终端

不要一开始就上 VPS。先在自己的电脑跑通 CLI，问题会少很多。

node -v
python3 --version
git --version
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes --version

2. 配置模型 Provider

优先选择一个你已经有额度的模型平台。首次配置后，重新打开一个终端再验证环境变量。

hermes setup model
hermes model
hermes config check
hermes doctor

3. 只读跑通第一轮

第一轮只让 Hermes 读文件、总结资料或生成草稿。不要立刻接删除、付款、群发这类动作。

hermes
/model
/skills
请根据当前项目生成一份只读检查清单

4. 再迁到长期运行环境

CLI 稳定后再接 Gateway 和 VPS。长期运行要有低权限用户、日志、重启策略和人工确认边界。

hermes gateway setup
hermes gateway start
hermes doctor
tail -n 80 <log-file>

环境变量怎么放

✓ API Key 只放在服务端环境变量或 Hermes 配置目录，不写进前端页面。
✓ 开发、测试、生产使用不同 Key，方便限额和撤销。
✓ 高权限 Token 单独命名，先不给 Agent 默认使用。
✓ 每次改完环境变量，重新打开终端或重启服务再验证。
export OPENROUTER_API_KEY="..."
export NOUS_API_KEY="..."
printenv | grep -E "OPENROUTER|NOUS"
hermes config check

成本与安全提醒

模型 API、VPS、消息平台和第三方 SaaS 会产生费用。不要把生产数据库写权限、付款权限或群发权限直接交给 Agent。

VPS 长期运行 checklist

  • ✓ 创建低权限运行用户，不用 root 长期跑任务。
  • ✓ 把 Hermes 工作目录、日志目录和备份目录分开。
  • ✓ 使用进程守护，失败后自动重启，并限制重启频率。
  • ✓ 日志至少保留 7 天，方便排查 Gateway、模型和工作流问题。
  • ✓ 消息平台只允许指定用户或频道调用。
  • ✓ 涉及写文件、发消息、改表格、开工单的动作先加人工确认。

安装完成怎么验收

模型已配置：`hermes model` 能看到当前模型并完成一次短对话。
记忆已启用：新会话能读取项目偏好或用户偏好。
Skills 已就绪：`hermes skills browse` 和 `/skills` 都能正常返回。
消息入口已连接：目标消息平台能收到测试回复。
工作流已通过：至少一个真实工作流完整跑通并留下日志。
运维项已就绪：重启、日志、限额和人工确认规则都已检查。