---
name: hermes-windows-support
description: All relevant skills and troubleshooting guides for installing, configuring, and troubleshooting Hermes Agent on Windows.
---

# Hermes Windows Support

## Windows 版 Hermes 安装指南

### 安装命令（从官网，不走 GitHub）

```powershell
irm https://hermes-agent.nousresearch.com/install.ps1 | iex
```

如果需要装到自定义路径（如 F 盘）：

```powershell
Invoke-WebRequest -Uri "https://hermes-agent.nousresearch.com/install.ps1" -OutFile "$env:TEMP\install.ps1"
& "$env:TEMP\install.ps1" -HermesHome "F:\hermes" -InstallDir "F:\hermes-agent"
```

### ⚠️ 安装完成后：先改语言，再配模型

Hermes 桌面版安装完成后，**第一步是先把界面改成中文**，然后再配置模型。

**改语言步骤：**
1. 打开 Hermes 桌面版
2. 点右上角 **Settings**（设置图标）
3. 找 **Language** 选项
4. 选 **中文 / Chinese**
5. 点 **Save** 保存

**如果已经跳到模型配置界面（没改语言）：**
- 屏幕上出现一串验证码/授权码，让你去浏览器填 → 这是 Nous Portal 的账号绑定流程
- 可以直接点 **Skip**（跳过）或 **Cancel**（取消）
- 先回设置改语言，再回来配模型

**教训：** 如果一开始就设置成中文，后续操作会简单很多。国外软件装完第一件事就是改语言。

### 模型配置（免费方案）

**强烈推荐：OpenRouter（免费，不需绑卡）**
1. 浏览器打开 `openrouter.ai`
2. 用**邮箱注册**（不要用 Google/Apple 登录，Google 登录可能要求绑卡）
3. 验证邮箱后登录
4. 点头像 → **Keys** → **Create Key**
5. 复制 Key，粘贴到 Hermes 模型配置里
6. 选一个免费模型，如 `google/gemini-2.0-flash:free` 或 `qwen/qwen-2.5-7b-instruct:free`

**不推荐：Nous Portal**
- 虽然有 300+ 免费模型
- 但 Google 登录后要求绑银行卡/Apple Pay（即使免费套餐也要绑卡验证）
- 用户不接受绑卡

### ⚠️ 安装卡住/转圈的常见原因

安装脚本克隆 Hermes 仓库时需要访问 `github.com`。如果被墙，安装会在 "CLONE HERMES REPOSITORY" 步骤一直转圈。

**解决方案：**

1. **打开 VPN 全局模式**（不是规则模式）— 所有流量走 VPN
2. **虚拟网卡模式（TUN 模式）必须打开** — 在 Clash Verge 设置中开启，这是关键！很多情况下不开 TUN 模式就装不上
3. 确认 VPN 能访问 GitHub（浏览器打开 `https://github.com/NousResearch/hermes-agent` 测试）
4. 重新运行安装命令

### Clash Verge 最佳设置（稳定不断线）

关键设置：
- **全局代理模式**（下载被墙资源时用，日常可切回规则模式）
- **虚拟网卡模式/TUN**：必须打开（很多软件安装需要）
- **DNS 覆写**：打开，填 `223.5.5.5` 和 `114.114.114.114`
- **IPv6**：关掉
- **统一延迟**：关掉
- **手动选择节点**：选绿色节点（延迟低），不要选红色/橙色感叹号节点
- **开机自启**：打开
- **静默启动**：打开
- **局域网连接**：不用开
- **UDP**：一般不用管，节点自带协议

**端口 7897** 是 Clash 默认 HTTP 代理端口，一般不用改。

**节点只有两个绿色说明 VPN 免费版节点质量差**，这是正常的。全局模式和规则模式的绿色节点数量不同，全局模式能看到更多节点。

### 张哥电脑配置（已确认）

- **内存：16GB**（不是 4GB！）
- **显卡：4GB**
- **硬盘：100GB+**
- **系统：Windows 11**
- **用户名：Administrator**

可以跑 7B 参数的本地多模态模型（如 Qwen-VL 7B、LLaVA 1.6）。

## 本地多模态模型（Ollama）

**首选：Ollama + Qwen2-VL (7B)**
```powershell
ollama pull qwen2-vl:7b
```

**备选：Ollama + LLaVA-1.6 (7B)**
```powershell
ollama pull llava:7b
```

安装 Ollama：浏览器打开 `ollama.com` 下载安装（可能需要 VPN）。

## 故障排除

### PowerShell 命令报错"未能解析远程名称"

说明访问不了目标域名（被墙或 DNS 问题）。解决方案：打开 VPN 全局模式。

### 安装脚本版本太老提示 / 节点显示"客户端版本太老"

Clash Verge 客户端版本太老 → 去官网下载最新版本升级。升级后绿色节点会恢复。

### 节点全部红色/橙色感叹号

说明当前 VPN 账号过期或节点不可用。换一个可用的节点。

### VPN 老是断线

- 重启 Clash Verge
- 换一个绿色节点
- 确保 TUN/虚拟网卡模式已打开
- 有些节点能看 YouTube 但下载不了 GitHub → 换节点试试

### OLLAMA 模型下载慢/卡住

Ollama 从 HuggingFace 下载模型，国内访问 HuggingFace 也需要 VPN。下载过程中断线会导致反复重连重新验证（转圈）。确保 VPN 稳定后再下载。

## 版本历史

- 2026-06-07 v2: 补充先后顺序（先中文后模型）、Nous Portal绑卡问题、OpenRouter邮箱注册、节点选择技巧、OLLAMA下载注意事项
- 2026-06-07 v1: 初版，整理 Windows 安装流程、VPN 设置、本地模型推荐