新手怎么装Hermes Agent v0.19.0避免常见坑

新手安装 Hermes Agent v0.19.0 这件事，说难不难，但一步踩错就能卡上半天。最常见的情况是：网络卡在 GitHub 克隆、PowerShell 权限不够、模型配置直接跳过——结果启动后弹出一个“No model configured”的报错，连个修复指引都没有。所以，别直接复制网上那些过时命令，得按环境适配的路径来走。

确认系统与安装路径

Windows 用户优先用 PowerShell 管理员模式执行脚本。但如果你用的是 Windows 10 2004 以前的版本，或者企业版禁用了脚本执行策略，那就老老实实改用 WSL2 + Ubuntu 22.04。Mac 和 Linux 用户则统一走终端 curl 脚本路径。这一步如果跳过，后续所有依赖安装都会失败，而且错误提示根本不会指向真正的根源。

检查当前 PowerShell 是否具备管理员权限：右键开始菜单 → 选择 Windows Terminal（管理员），看到提示符前有

字样才算达标。

Windows 原生安装（推荐国内镜像）

在管理员 PowerShell 中逐行执行：

irm https://res1.hermesagent.org.cn/install.ps1 | iex

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

注意：必须用 irm（Invoke-RestMethod），不能用 curl 或 wget，否则脚本无法执行。

等待终端输出 Installation completed successfully 后，关闭并重新打开一个全新的 PowerShell 窗口——旧窗口的环境变量没有刷新，直接运行 hermes 命令会提示“找不到命令”。

WSL2 + Ubuntu 安装（绕过 Windows 权限限制）

在管理员 PowerShell 中依次执行：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

然后重启电脑。

wsl --set-default-version 2

接着在 Microsoft Store 里搜索并安装 Ubuntu 22.04 LTS，首次启动时设置用户名和密码。

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

安装完成后，输入 hermes --version，必须返回 Hermes Agent v0.19.0 才算通过基础验证。如果报错 command not found，说明脚本没有自动写入 PATH，需要手动执行 source ~/.bashrc。

安装后必做的初始化配置

无论你用的是哪种安装方式，安装完成后必须立即运行：

hermes setup

选择 Quick Setup，然后按提示输入 Y 确认全部默认路径，等待生成 ~/.hermes/config.yaml。这一步如果跳过，Hermes 启动时会直接崩溃，并报错 No model provider configured，而且不会给你任何修复指引。配置文件生成后，建议手动检查一下该文件是否存在、是否为空——空文件说明向导中途被中断，需要重新跑一遍 setup。

国内用户推荐在此步骤中选择 Kimi 或 智谱AI，填入 API Key 后系统会自动测试连通性，如果失败会立刻提示，不会让你进入下一步。