Hermes Agent Windows 安装中文指南

三种方式快速对比

方式一：WSL2 + Docker（推荐）

这是最接近 Linux 原生的方式，长期稳定、性能损失 < 5%。

1. 启用 WSL2

# PowerShell（管理员）
wsl --install
# 重启后，默认装 Ubuntu 22.04
wsl --set-default-version 2

2. 在 WSL Ubuntu 里装 Docker

# 在 Ubuntu shell 里
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# 退出重进，让用户组生效

3. 拉 Hermes 镜像并运行

docker run -d \
  --name hermes \
  -p 8642:8642 \
  -v ~/.hermes:/root/.hermes \
  -e OPENROUTER_API_KEY="sk-or-..." \
  ghcr.io/nousresearch/hermes-agent:latest

4. 在 Windows 浏览器里访问

WSL2 默认把容器端口映射到 localhost。打开浏览器访问 http://localhost:8642 就能看到 Hermes Gateway UI。

方式二：Docker Desktop

不想碰 WSL 命令行，可以装 Docker Desktop for Windows。它会自动开启 WSL2 后端。

1. 下载 Docker Desktop
2. 装完启动，等右下角图标变绿
3. 打开 PowerShell 跑：

docker run -d -p 8642:8642 ghcr.io/nousresearch/hermes-agent:latest

注意：Docker Desktop 在 Windows Home 上需要 WSL2，在 Windows Pro 上还可以用 Hyper-V 后端（一般推荐用 WSL2，更轻）。

方式三：Hermes Desktop App

如果只想要“个人桌面 AI 助手”，不需要 Telegram / Discord 渠道、不需要 24/7 跑，可以直接装 Hermes Desktop App（GitHub Release 上有 .exe 安装包）。

详见 Hermes Desktop App（英文）。

常见坑

1. WSL2 网络共享

Windows 防火墙默认会拦 WSL2 容器对外的连接。如果机器人收不到 Telegram webhook，去“高级安全防火墙”里允许 WSL2 出站。

2. CRLF 换行问题

如果你从 Windows 编辑 config.yaml，VS Code / Notepad 默认存成 CRLF，Hermes 在 Linux 容器里读不对。两个修复：

# 方式 A：VS Code 右下角选 LF
# 方式 B：在 WSL Ubuntu 里改
dos2unix ~/.hermes/config.yaml

3. Hyper-V 冲突

如果同时装了 VirtualBox / VMware 老版本，可能和 WSL2 抢 Hyper-V。优先关掉别的虚拟化软件。

4. WSL 重启后容器丢了

WSL2 内核重启后 Docker daemon 不会自动起。两条路：装 systemd（WSL 0.67+ 支持）后开 docker 服务自启；或者每次手动 sudo service docker start。

免去 Windows 部署 —— 用 OpenClaw Launch 托管

不想在自己电脑上跑：直接用 Hermes Hosting 托管版本。首月 $3，之后 $6/月，全套 Web Dashboard + 多渠道 + 持久化已经搭好，不用碰 WSL / Docker / 防火墙。

验证 Hermes 跑起来了

curl http://localhost:8642/health
# 应返回 {"status":"ok"}

curl -X POST http://localhost:8642/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"openrouter/openai/gpt-4o-mini","messages":[{"role":"user","content":"hi"}]}'

下一步

• Hermes Agent 安装与配置（通用）
• Hermes Skills 中文指南
• Hermes + Telegram 接入
• Hermes + 微信接入
• Hermes Agent Windows（英文详解）