如何把 Hermes Agent 部署到 Windows 电脑上
如果你想在 Windows 电脑上稳定使用 Hermes Agent，我更推荐通过 WSL2 和 Ubuntu 来运行：
Windows 11 / Windows 10→ 安装 WSL2→ 安装 Ubuntu→ 在 Ubuntu 里安装 Hermes Agent这样做的原因很简单：Hermes Agent 的强项在于终端、文件系统、自动化、脚本、Git、浏览器工具链和各种开发依赖。这些能力在 Linux / macOS / WSL 环境里通常更稳定，也更接近官方和社区最常用的运行方式。
你将获得什么
Section titled “你将获得什么”完成本教程后，你会得到：
- 一个可正常运行的 Hermes Agent 环境。
- 可直接执行
hermes命令的终端。 - 可继续配置模型、工具和网关的平台基础环境。
第 1 步：确认 Windows 版本
Section titled “第 1 步：确认 Windows 版本”优先建议使用：
- Windows 11
- Windows 10 2004 及以上版本
如果版本太旧，先更新系统再继续。
第 2 步：以管理员身份安装 WSL2
Section titled “第 2 步：以管理员身份安装 WSL2”打开 PowerShell 管理员窗口，执行：
wsl --install如果系统已经启用了 WSL，但还没有安装 Ubuntu，可以执行：
wsl --list --onlinewsl --install -d Ubuntu安装完成后重启电脑。
第 3 步：首次启动 Ubuntu
Section titled “第 3 步：首次启动 Ubuntu”重启后，在开始菜单打开 Ubuntu。第一次启动时，系统会提示你设置：
- Linux 用户名
- Linux 密码
记住这组账号密码，后面安装软件时会用到。
第 4 步：更新 Ubuntu 基础环境
Section titled “第 4 步：更新 Ubuntu 基础环境”在 Ubuntu 终端里执行：
sudo apt update && sudo apt upgrade -ysudo apt install -y curl git build-essential这一步的目标是先把最基本的下载、Git 和编译工具准备好。
第 5 步：安装 Hermes Agent
Section titled “第 5 步：安装 Hermes Agent”继续在 Ubuntu 终端执行：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装结束后，关闭终端并重新打开一次 Ubuntu，或者手动刷新 shell 环境。
然后检查是否安装成功：
hermes --version如果能看到版本号，说明已经安装好了。
第 6 步：运行初始化配置
Section titled “第 6 步：运行初始化配置”首次使用时，建议先执行：
hermes setup你可以在这里配置：
- 默认模型或 Provider。
- 终端行为。
- 网关平台。
- 常用工具开关。
如果你已经知道自己要用哪个模型，也可以后面再执行：
hermes model第 7 步：做一次健康检查
Section titled “第 7 步：做一次健康检查”执行：
hermes doctor这个命令可以帮助你检查当前环境里是否有：
- 缺失依赖。
- 配置问题。
- 模型或认证问题。
如果 doctor 没有报告关键错误，就说明基础环境已经能用了。
第 8 步：做一次最小测试
Section titled “第 8 步：做一次最小测试”你可以直接跑一条简单命令：
hermes chat -q "用一句话介绍 Hermes Agent 是什么"如果可以返回正常结果，说明 Hermes Agent 已经真正跑通。
最稳的组合通常是：
Windows 负责日常桌面使用WSL Ubuntu 负责 Hermes Agent、Git、脚本和自动化VS Code 通过 Remote - WSL 连接 Ubuntu 项目目录如果你后面要让 Hermes 帮你改代码、跑脚本、操作 Git、构建网站或自动发布内容，这种方式会比纯 Windows 命令行直装省很多麻烦。