从0到1部署“Hermes爱马仕”：Windows用户的三步通关秘籍（附隐藏大坑）

01 | 简介

AI Agent 圈子里又出来个新秀叫 Hermes Agent（很多网友亲切地称其为“爱马仕”），由 Nous Research 开源。好家伙，这名字一听就来头不小——Hermes 可是希腊神话里的信使神，跑得比谁都快。

我自然是忍不住要上手把玩一番，主要是想做些事情。然而，这一把玩不要紧，又整整折腾了我三天。

今天就把这个Windows 用户最丝滑的安装路径以及那个史诗级隐藏大坑全盘托出。

02 | Windows 推荐三步法

Hermes Agent 原生是为 Linux 环境设计的。Windows 用户想玩？WSL2（Windows Subsystem for Linux） 才是正解。

三步走：安装 WSL2 → 安装 Ubuntu-22.04 → 安装 Hermes Agent。

2.1 安装 WSL2

管理员身份打开 PowerShell，命令如下：

wsl --installdism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestartdism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestartwsl --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 Linux系统，命令如下：

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. 填入 Hermes Agent 配置

下图，充值之后可以正常对话了

04 | 小结

(1) Windows 用户安装 Hermes Agent，WSL2 + Ubuntu-22.04 是最推荐的路径，简单粗暴，丝滑流畅。

(2) API Key 绑定完成 ≠ 万事大吉，务必确认云端大模型账户已充值，哪怕是一块钱。这是官方文档不会告诉你、AI 助手也答不上来的隐藏关卡。

(3) 最后，分享Hermes官方的快速入门链接：

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

哈哈，我给我的爱马仕取了个名字，叫做“电源先生的小助理”。下一步，我也想让它帮我点杯咖啡...