HermesAgent Windows原生离线安装包，无需魔法，无需 WSL 轻松在 Win 环境使用 Hermes

这是一篇面向 Windows 用户的 HermesAgent 安装指南。无需 WSL、无需魔法网络，也不需要额外折腾依赖；按文中的步骤操作，就可以在纯 Windows 环境完成 Hermes 的安装、模型配置与微信接入。

# HermesAgent Windows原生离线安装包，无需魔法，无需 WSL 轻松在 Win 环境使用 Hermes

> 这是一篇面向 Windows 用户的 HermesAgent 安装指南。无需 WSL、无需魔法网络，也不需要额外折腾依赖；按文中的步骤操作，就可以在纯 Windows 环境完成 Hermes 的安装、模型配置与微信接入。

---

## 安装方式总览

| 场景 | 推荐方式 | 说明 |
|---|---|---|
| 电脑具备代理 / 魔法网络 | 在线安装 | 直接复制安装命令到 PowerShell，通常是最快的安装方式。 |
| 电脑没有代理 / 魔法网络 | 离线安装包 | 下载预打包好的离线安装包，双击脚本即可完成部署。 |

---

## 方案一：具备代理 / 魔法网络时在线安装

> 如果你的 Windows 电脑具备代理 / 魔法网络，优先使用这种方式，步骤更少、安装也更快。

1. 复制 Windows 安装命令到 PowerShell 中执行。
2. 或者直接执行下面这一条安装命令：

```powershell
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
```

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NDcyNmVhODFmODIyOTk5YjIwNDk2ZWVjNWQxOTI0YTVfOTkzMGFkNmRkNTlhZTQ5MTE3NDA4NjY2MWZlZTg5ODJfSUQ6NzYzOTcwODEwOTI3MTA1OTQyMl8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

执行后按提示等待安装完成即可。

---

## 方案二：没有代理 / 魔法网络时使用离线安装包

> **离线包下载地址**
>
> - 百度网盘：（提取码：f2uq）
> - 夸克网盘：

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=MGE5NTRhYjZmNzhmYzljYTdmMjNhOTg1MzEyYTUyMDVfNzc4NWU0YTFjMTY5NDE3ZWNmZDBhNGRhNDI1Y2QwNjZfSUQ6NzYzOTcwODExMjExNjQ4NTA5M18xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

1. 下载并解压 Hermes 离线安装包。
2. 双击运行 `安装 hermes.cmd`。安装包里已经带好了最新版源码和依赖，通常不需要额外配置。

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=OWJmYWFjNDVkZmY0ZGY1ODE4MjE0MDQxM2NlMjViMzNfYjk3NGJlMmM5NjVkNmRhMWEwNTc1NTNiODA5MjRhMzJfSUQ6NzYzOTcwODExMTk4OTIxNDE1M18xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=YWZhNTQ1MWQ1MzgwMGRmNDNkODA1MDljNmQ0YzQ0MTRfNGI3NmMyMzI2ZTg1YjNhYTIyNDZmNGVlNGE4NjI1ZTZfSUQ6NzYzOTcwODExNDMxNzAyMDA5Ml8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NDY1MTdkYjYyODllYWU0ODVhMTkyZDA0ZTRmNjgyMGFfOGQ3ODI1NGVhYTc4MGU2OTBlYTdkOTQxN2Y0ODI0NjVfSUQ6NzYzOTcwODExODc3MTEwODgwOV8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

安装过程通常需要 2 到 3 分钟。完成后按任意键退出安装程序。

---

## 验证安装是否成功

1. 打开 PowerShell 或 CMD。
2. 输入 `hermes --version`。
3. 如果终端能正常输出版本号，说明 Hermes 已经安装完成。

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=M2FlYzA1Y2FjY2M3NjFkYWVhNGIwY2FiZjkxMmE5YzRfZjZjMjhiZjRjZTcwNDA4OTIwZDJlNjZlOThjOTk3YzNfSUQ6NzYzOTcwODEyMjY0NjM2NzE4OF8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

---

## 配置 Hermes 的 API 服务

> **配置时最容易出错的是 API Key 粘贴方式。** 在 Windows 终端中，不要用 `Ctrl + V`；请只使用鼠标右键粘贴一次。多次右键会重复粘贴，容易导致 Key 错误。

1. 执行 `hermes model` 进入模型配置向导。
2. 如果你使用自定义服务商，可选择对应编号；你当前文档中使用的是 36。

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=ODc0M2UyNTBkYjUyZTg3ZDk1ZjYyMDM3MGZhYmRmMzdfZGU3MjA4Yzc1MjFjNjE0M2JhZGQ3OWIyNjdhNGJiYWFfSUQ6NzYzOTcwODEyNDk1NzQ5NDIwMF8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NWE4MmVhMzYyYWM2OGYwYjc3NzMyODhmN2ZkMDFmMzZfOTk2OGY1NzBmZWQ4NjE2ZDA3M2YxNTI0MWI1ODBjMmFfSUQ6NzYzOTcwODEyNDAyNDMyNzExM18xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

接下来依次填写 Base URL 和 API Key。

**输入 Base URL：**

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NjQ3ZjA0NGIzNDI5MWI4YTJlOTQ3Zjc1N2FhYmRjODNfODgxYmZlNWM2YWFiMDdlOGRhNWUwN2IyY2U0MjcwMzhfSUQ6NzYzOTcwODEyNjQzNDMxNTIyMF8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

**输入 API Key：**

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=MWZjMTc4Njg1ZjM1MGMyNGJmOGMwNTk2MzU0ODhkY2ZfMzkyZDI0MjFlYjcyNTYyZjcxYzdiOGUwMTgxMTIzYjhfSUQ6NzYzOTcwODEzMTIyMzg5OTA4M18xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

如果 Base URL 和 API Key 都正确，终端通常会列出可用模型。你这份配置里选择的是编号 7。

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NmUyODg2MzMyY2Y5MjVmMjUwZjc1YjA3YmE0MjRkNmZfYWQ5OGUzMzZhMmVjNTM2MWZmZTFkYTE5Mzk2NTJiODFfSUQ6NzYzOTcwODEzMTE1Mjg5MDg0OV8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

---

## 启动 Hermes 并验证回复

1. 在终端输入 `hermes`，启动 Hermes TUI。
2. 随意发送一条消息进行测试。
3. 如果能正常收到回复，说明 Hermes 已经配置成功。

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=ZTQzNTliNTc5MDA2YjZlNzc3NDFlZTc1NDA2ZmUwOWZfMjQ4MTc0N2U0YWJhNWUzNDYwMTc2ZTJiYmJiOWQ1MGZfSUQ6NzYzOTcwODEzNTc1MzY5ODI0Ml8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)