hermes agent在windows上原生运行必须依赖wsl2，因其重度依赖linux内核工具链；官方推荐wsl2部署，亦提供powershell一键安装的beta方案供快速体验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 Windows 系统上原生运行 Hermes Agent，但发现直接安装失败或报错频繁，则很可能是因缺少 Linux 兼容环境所致。Hermes Agent 官方明确要求 Linux 内核级支持，而 WSL2 是目前唯一被完全验证且官方推荐的 Windows 部署路径。以下是针对该场景的多路径实操部署方案：
一、WSL2 基础环境搭建（强制前置）
WSL2 提供完整的 Linux 内核隔离环境，是 Hermes Agent 在 Windows 上稳定运行的底层基础。跳过此步将导致后续所有安装命令失败或功能异常。
1、以管理员身份打开 PowerShell，执行：wsl --install
2、系统提示下载完成后，必须重启电脑，否则 WSL2 内核无法激活。
3、重启后再次打开 PowerShell（普通用户权限即可），运行：wsl --set-default-version 2
4、验证是否启用成功：运行 wsl -l -v，确认 Ubuntu 条目对应的 VERSION 列显示为 2。
5、前往 Microsoft Store 搜索并安装 Ubuntu 22.04 LTS（官方测试矩阵标准版本，兼容性最优）。
6、首次启动 Ubuntu 时，按提示创建用户名与密码——用户名需全小写、无空格及中文；密码输入时屏幕无回显属正常现象，盲打后回车即可。
二、网络模式关键配置（避坑核心）
WSL2 默认 NAT 网络模式会隔离代理设置，导致 curl 下载镜像超时、API 连接失败等静默错误。必须切换为 Mirrored 模式以继承 Windows 主机网络策略。
1、在 Windows 设置中搜索“适用于 Linux 的 Windows 子系统”，打开对应设置面板。
2、将网络模式从默认的 NAT 改为 Mirrored。
3、勾选以下三项：关闭防火墙、启用 localhost 转发、自动代理开启。
4、完成设置后，再次重启电脑，确保网络策略生效。
三、Hermes Agent 安装（双通道可选）
根据实际网络条件选择对应安装方式，国内用户强烈推荐使用镜像版以规避 GitHub raw.githubusercontent.com 访问失败问题。
1、启动 Ubuntu 终端，确认已进入 WSL2 环境（终端提示符含用户名@主机名）。
2、若可科学上网，执行国际版安装命令：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
3、若处于国内网络，执行镜像版安装命令：curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
4、安装过程中如提示选择组件（如语音模块），可根据需求按空格键切换选项，最后按 Tab 键移至 OK 并回车确认。
5、等待终端输出 Installation completed successfully 后，表示主程序已就位。
四、模型与 API 初始化配置
hermes setup 命令将引导完成模型供应商绑定与密钥注入，该步骤决定 Agent 是否具备实际推理能力。未完成此步则 Agent 启动后无法调用任何大模型。
1、在 Ubuntu 终端中输入：hermes setup
2、在模型提供商列表中，选择支持中文且响应稳定的国内服务，例如 MiniMax 或 Kimi。
3、访问对应平台申请 API Key，并在终端粘贴——注意：终端不显示字符是正常现象，粘贴完毕直接按回车。
4、选择默认模型名称（如 abab6.5s-chat），确认后等待初始化完成。
5、验证模型加载状态：运行 hermes model list，输出中应包含已配置的模型标识及状态 active。
五、Windows 原生免 WSL 方案（Beta 替代路径）
针对部分不愿启用 WSL2 的用户，Hermes Agent 社区提供了 Windows 原生命令行安装脚本，该方案通过内置 uv 包管理器自动拉取 Python/Node.js/Git 等全部依赖，无需手动配置环境变量。
1、打开 PowerShell（无需管理员权限），执行：irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
2、安装过程自动完成依赖检测与安装，包括 Python 3.11、Node.js 22、PortableGit 及虚拟环境构建。
3、安装结束后，必须关闭当前 PowerShell 窗口，重新打开一个全新终端，否则 PATH 未刷新会导致 hermes 命令不可识别。
4、新终端中运行 hermes --version，确认输出版本号（如 v0.8.1）即表示安装成功。
5、后续配置仍需执行 hermes setup 完成模型绑定，流程与 WSL2 环境一致。
