HermesAgent.Work
安装部署

Hermes Agent Windows、Linux、macOS 安装补充:怎么选最稳路线

面向中文用户补充 Windows WSL2、Windows PowerShell Early Beta、Linux、macOS 的安装路线、命令和验收清单。

先选系统路线

安装前先不要急着复制命令。不同系统的稳定程度不一样: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 setup

Windows 原生 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 doctor

macOS 安装路线

macOS 用户通常只需要确认 Git 可用,然后运行一键脚本。安装后如果提示 `hermes` 找不到,重新加载 shell 配置或开一个新终端。

git --version
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
hermes setup

Linux 安装路线

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 分类和内容选题三个低风险任务开始。