---
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 仓库时需要访问 `github.com`。如果被墙，安装会在 "CLONE HERMES REPOSITORY" 步骤一直转圈。

**解决方案：**

1. **打开 VPN 全局模式**（不是规则模式）— 所有流量走 VPN
2. **打开虚拟网卡模式（TUN 模式）** — 在 Clash Verge 设置中开启，这是关键！
3. 确认 VPN 能访问 GitHub
4. 重新运行安装命令

### Clash Verge 最佳设置

- **全局代理模式**（下载被墙资源时用）
- **虚拟网卡模式/TUN**：必须打开
- **DNS 覆写**：`223.5.5.5` 和 `114.114.114.114`
- **IPv6**：关掉
- **手动选择节点**：选绿色节点

### 张哥电脑配置

- **内存：16GB**
- **显卡：4GB**
- **硬盘：100GB+**
- **系统：Windows 11**

## 本地模型连接（LM Studio）

### LM Studio 启动本地服务

1. 打开 LM Studio
2. 左侧边栏点 **Developer**（开发者）图标（Ctrl+2）
3. 点 **"Load Model"** 加载已下载的模型
4. 确认服务地址（默认 `http://127.0.0.1:1234`）
5. ⚠️ **不需要注册登录 LM Studio 账号**

### Hermes 连接 LM Studio

1. 打开 Hermes 桌面版 → 右上角设置齿轮
2. 模型提供者选 **"LM Studio"**
3. 地址自动填 `http://127.0.0.1:1234`
4. 模型名填 `qwen2.5-vl-7b`
5. **API Key 留空**
6. 上下文长度：**4096**（4GB 显卡推荐）
7. 保存

### ⚠️ 上下文长度问题

- Hermes 默认要求最低 **64000** 上下文
- 4GB 显卡跑 64000 会卡死
- **Qwen2.5-VL-7B 最大只支持 4096 上下文**
- 解决：`hermes config set model.context_length 4096`
- 如果报错，在 `config.yaml` 中手动改：
  ```yaml
  model:
    context_length: 4096
  ```

### ⚠️ 压缩功能报错

如果报错 "compression model context window below minimum 64,000"：
```
hermes config set compression.enabled false
```

### LM Studio 界面

- **Chat**（Ctrl+1）：聊天
- **Developer**（Ctrl+2）：开发者设置/本地服务器
- **My Models**（Ctrl+3）：已下载模型
- **Model Search**（Ctrl+M）：搜索新模型

### 已知问题

- "LM Link" 功能不需要管
- 蓝色登录框（Login/Req）直接跳过
- 上下文长度改了后需要**重新加载模型**
- 4GB 显卡不要尝试 64000 上下文

## 故障排除

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

打开 VPN 全局模式。

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

VPN 账号过期或节点不可用，换节点/机场。

## 版本历史

- 2026-06-07: 初版
- 2026-06-08: 更新 LM Studio 连接方法、上下文长度问题