先选系统路线
安装前先不要急着复制命令。不同系统的稳定程度不一样:Windows 新手优先选 WSL2;想快速体验原生 CLI 的用户可以尝试 PowerShell Early Beta;macOS 和 Linux 直接走一键脚本最省心。
Windows 推荐路线:WSL2
WSL2 是 Windows 上更稳的使用方式。它等于在 Windows 里运行一个 Linux 环境,Hermes Agent 的终端、脚本、工具调用和日志路径都更接近 Linux/macOS。
wsl --install
wsl --set-default-version 2安装完成后打开 Ubuntu 终端,再运行 Linux/macOS 的一键脚本:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setupWindows 原生 PowerShell:Early Beta
官方已经提供原生 PowerShell 安装路线,但仍建议按 Early Beta 看待。它适合想快速体验 CLI 的用户;如果你准备长期跑 Gateway、定时任务和复杂工具链,仍建议优先选择 WSL2。
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex安装后新开一个 PowerShell 窗口,再运行:
hermes setup
hermes doctormacOS 安装路线
macOS 用户通常只需要确认 Git 可用,然后运行一键脚本。安装后如果提示 `hermes` 找不到,重新加载 shell 配置或开一个新终端。
git --version
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
hermes setupLinux 安装路线
Ubuntu、Debian、VPS 用户先确认 Git 和 curl,再运行脚本。个人电脑建议普通用户安装;共享服务器或生产环境再考虑低权限用户、日志目录和进程守护。
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安装后统一验收
无论系统是什么,最后都按同一套标准验收:Provider 能配置,Memory 能启用,Skills 目录可用,Gateway 不要急着接生产群。
hermes doctor
hermes model
hermes skills browse
hermes config check常见错误
- `hermes: command not found`:重新打开终端,或执行 `source ~/.bashrc` / `source ~/.zshrc`。
- `git not found`:先安装 Git,再重跑安装脚本。
- 模型不可用:先用 `hermes model` 重新选择 Provider,再跑 `hermes doctor`。
- Windows 路径混乱:WSL2 与原生 Windows 的数据目录不同,不要混用配置。
新手建议
第一次安装只追求一件事:能打开 Hermes 并完成一次短对话。确认 CLI 稳定后,再配置 OpenRouter、Skills、消息平台和 VPS 长期运行。
下一步
如果你还没有真实场景,可以先领取 Free Starter 模板包,从每日简报、Issue 分类和内容选题三个低风险任务开始。