Windows 用户可以用 Hermes Agent,但如果你不是专门想测试原生 Windows 路线,优先建议走 WSL2。官方安装文档把 Windows 原生标为 early beta,并说明更经受验证的方案是 WSL2。
这不是说 PowerShell 安装不能用,而是 AI Agent 会调用 shell、Git、Node、Python、浏览器和各种工具,环境差异越少,排障越简单。WSL2 更接近 Linux/macOS 文档里的主路径,遇到问题也更容易套用社区经验。
该选哪种安装方式
如果你主要做代码、脚本、服务器运维,选 WSL2。安装 Ubuntu 后,在 WSL 终端执行官方 Linux 一键安装命令,再用 hermes setup 配模型和工具。
如果你就是想在 Windows 终端里直接跑,官方也提供 PowerShell 安装命令,并会处理 Python、Node、ripgrep、ffmpeg、Git Bash 等依赖。但原生 Windows 仍可能遇到路径、编码、终端 PTY、浏览器面板等细节问题。
常见卡点怎么查
安装后输入 hermes 找不到命令,先重开终端或加载 shell 配置。模型报 API key 缺失,退出会话后运行 hermes model。依赖或配置不确定,直接跑 hermes doctor,它会列出环境摘要和缺失项。
网关常驻也要注意:WSL 环境里官方文档建议用 hermes gateway run,可以配合 tmux 保持运行;Windows 原生则按对应服务方式处理。
新手最稳的路径是:WSL2 安装、先跑 CLI、再开网关、最后再接复杂工具。先把主流程跑通,比在两套环境之间来回修问题更省时间。