跳转到主要内容
HermesAgent.Work
安装部署

Hermes Agent 安装路线怎么选：原生 Windows、WSL2、macOS 与 Linux

面向中文用户整理原生 Windows、WSL2、Linux、macOS（Apple Silicon）的安装路线、命令和验收清单，已对照 Hermes Agent v0.21.5 核对。

更新 2026-10-0710 分钟阅读安装部署WindowsWSL2LinuxmacOS安装

最后更新 2026-10-07 · HermesAgent.Work 编辑组 整理维护（内容维护说明）· 步骤过时或无法复现可反馈

先选系统路线

安装前先不要急着复制命令，先看你的系统在官方支持范围里属于哪一档（以下对照 Hermes Agent v0.21.5）：

  • macOS：只支持 Apple Silicon（M 系列芯片），Intel Mac 不在支持范围内。
  • Windows 10/11：原生安装已经正式支持，不再是早期测试版；WSL2 仍然可用，但不再是必须。
  • Linux：主流发行版都支持，个人电脑和 VPS 用同一个安装脚本。
  • Android（Termux）：属于尽力维护的平台，能用但更新可能滞后。

macOS 和 Windows 官方推荐的方式是到官网下载 Hermes Desktop 安装包，它会同时装好命令行和桌面版（装法和切换中文界面见 Hermes Desktop 桌面版指南）。只想要命令行，就用下面的一行命令。

Windows 原生：PowerShell 一行命令

在 PowerShell 里运行：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安装脚本会自动装好 Python、Node.js、ripgrep、ffmpeg 和一份便携 Git Bash，不需要管理员权限，也不会影响你系统里已有的 Git。装完新开一个 PowerShell 窗口：

hermes --version
hermes

原生安装的数据在 %LOCALAPPDATA%\hermes。杀毒软件把 uv.exe 报成恶意程序是官方文档里说明过的误报，放行即可。目前只有仪表盘里的内置终端窗格还需要 WSL2，CLI、网关、TUI 和工具都能原生运行。

Windows 上用 WSL2

如果你本来就习惯 Linux 工具链，或者需要完整的 POSIX 环境，可以继续用 WSL2：

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

装好后打开 Ubuntu 终端，按 Linux 方式安装：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
hermes

WSL2 里的数据在 ~/.hermes，和原生安装是两套独立环境，配置不要混用。

macOS 安装路线

确认是 Apple Silicon 的 Mac、Git 可用，然后运行一键脚本。装完如果提示 hermes 找不到，重新加载 shell 配置或开一个新终端。

git --version
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc
hermes

只装了命令行、之后想加装桌面版，运行 hermes desktop。

Linux 安装路线

Ubuntu、Debian、VPS 用户先装好 Git、curl 和 xz-utils（安装脚本下载 Node.js 时要用），再运行脚本。个人电脑建议普通用户安装；共享服务器或生产环境再考虑低权限用户、日志目录和进程守护。

sudo apt update
sudo apt install -y git curl xz-utils
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
hermes

服务器不需要浏览器自动化的话，可以加 --skip-browser 跳过 Playwright 浏览器下载：curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser。

安装脚本做了什么

Python、Node.js、ripgrep、ffmpeg 都不用自己提前装，脚本会检测缺什么补什么，然后 clone 代码、建虚拟环境、注册全局 hermes 命令，最后进入设置向导配置模型。国内网络下 clone GitHub 和下载依赖这几步容易卡，见国内安装指南。

安装后统一验收

无论系统是什么，最后都按同一套标准验收：

hermes doctor
hermes status
hermes

doctor 查依赖、配置和 Key，status 看各组件状态，最后打开会话发一句短问题，能在合理时间内回复就算装好了。消息平台不要急着接生产群。

常见错误

  • hermes: command not found：重新打开终端，或执行 source ~/.bashrc / source ~/.zshrc；Windows 原生在 PowerShell 里用 Get-Command hermes 查。
  • git not found：先安装 Git，再重跑安装脚本。
  • 模型不可用：先用 hermes model 重新选择 Provider，再跑 hermes doctor。
  • Windows 路径混乱：WSL2 与原生 Windows 的数据目录不同，不要混用配置。

新手建议

第一次安装只追求一件事：能打开 Hermes 并完成一次短对话。确认 CLI 稳定后，再配置 OpenRouter、Skills、消息平台和 VPS 长期运行。

还没有真实场景？可以先领取 Free Starter 模板包，从低风险只读任务开始试跑。