Windows用户三步部署爱马仕Hermes避坑指南

01 | 简介

AI Agent 领域近期迎来了一位备受关注的新成员——Hermes Agent，由 Nous Research 开源发布。许多开发者亲切地称其为“爱马仕”。从命名即可看出其不凡之处：Hermes 源自古希腊神话中的信使神，以敏捷与速度著称。

出于好奇，我决定亲自上手体验一番。原本只想简单测试，没想到一探究竟就投入了整整三天时间。今天，我将为 Windows 用户梳理一条最顺畅的安装路径，并揭露一个鲜少被提及的关键问题，让你一次性掌握全部要点。

02 | Windows 推荐三步法

需要说明的是，Hermes Agent 本质上是为 Linux 环境开发的。对于 Windows 用户而言，WSL2 是实现部署的最佳选择。

整体流程分为三步：安装 WSL2 → 安装 Ubuntu-22.04 → 安装 Hermes Agent。

2.1 安装 WSL2

以管理员身份启动 PowerShell，依次运行以下命令：

wsl --install
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
wsl --set-default-version 2

请耐心等待各命令执行完毕，完成后重新启动计算机。

2.2 安装 Ubuntu-22.04

继续在管理员 PowerShell 中执行：

wsl --install -d Ubuntu-22.04

等待安装完成，根据提示重启系统。重启后进入 Ubuntu，设置你的 Linux 用户名与密码即可。

2.3 安装 Hermes Agent

接下来是核心环节。打开 PowerShell，通过 wsl 命令进入刚才部署的 Ubuntu 环境，然后运行：

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

2.4 大功告成

安装完成，一切似乎进展顺利。

03 | 史诗级隐藏大坑

前面三步可能已经耗费了不少精力，当你以为终于到达终点时，实际运行却可能疯狂报错：

⚠️ API call failed (attempt 1/3): BadRequestError [HTTP 400]
Provider: zai Model: glm-4.7
Endpoint: https://api.z.ai/api/paas/v4
Error: HTTP 400: Error code: 400
⏱️ Elapsed: 1.58s Context: 2 msgs, ~1,244 tokens
⚠️ Non-retryable error (HTTP 400) — trying fallback...
? Request debug dump written to: C:Users45355.hermessessionsrequest_dump_20260524_212600_e56254_20260524_212719_738811.json
❌ Non-retryable error (HTTP 400): HTTP 400: Error code: 400
❌ Non-retryable client error (HTTP 400). Aborting.
Provider: zai Model: glm-4.7

我反复检查了 API Key、配置参数、网络连接，甚至向豆包和千问求助，都未能解决问题。三天过去了，直到偶然打开云端大模型控制台，看到了“账户充值”字样。抱着试一试的心态，我给 Kimi 账户充值了10元——还额外获赠了15元，体验不错。

原来，仅仅绑定 API Key 是远远不够的。你还需要给对应的云端大模型账户充值，哪怕只充入一块钱，确保账户处于“有余额”状态，HTTP 400 错误才会彻底消失。之前反复出现的报错，根源就在于账户未充值。

完整的正确流程应该是：

1. 注册云端大模型服务，生成专属 API Key
2. 为账户充值（这一步极其隐蔽，豆包、千问等工具也从未提示）
3. 将 API Key 填入 Hermes Agent 配置文件

下图展示了充值成功后正常对话的效果。

04 | 小结

（1）对于 Windows 用户，通过 WSL2 + Ubuntu-22.04 部署 Hermes Agent 是最推荐的方案，操作简洁，运行流畅。

（2）API Key 配置完成并不代表一切就绪，务必确认云端大模型账户已成功充值，哪怕只是一块钱。这是官方文档未曾提及、AI 助手也难以解答的隐藏门槛。

（3）最后附上 Hermes 官方快速入门链接，供你参考：

https://hermesagent.org.cn/docs/getting-started/quickstart

顺便一提，我给它起了个名字，叫“电源先生的小助理”。下一步，打算让它帮我点杯咖啡试试。