Windows部署爱马仕从零开始三步通关避坑指南

2026-05-28阅读 0热度 0

windows

01 | 概述

AI Agent 领域近期迎来一位新成员：Hermes Agent。社区常简称为“爱马仕”，由 Nous Research 开源。其名称源自希腊神话中以速度闻名的信使神赫尔墨斯，注定不平凡。

上手尝试后，原计划短暂测试，结果耗费三天时间。本文专为 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 远远不够。必须确保对应云端大模型账户存在余额，即使只充 1 元。此前所有 HTTP 400 错误的根源正是账户余额为零。

完整正确的流程为：

注册云端大模型，生成 API Key
向账户充值（该步骤极为隐蔽，豆包、千问均未提及）
将配置填入 Hermes Agent

下图展示充值后正常交互的界面。

04 | 总结

（1）Windows 用户部署 Hermes Agent 时，WSL2 + Ubuntu-22.04 是最推荐的路径，操作简单且运行流畅。

（2）API Key 绑定完成并不等于万事大吉；务必确认云端大模型账户已充值，哪怕仅仅 1 元。这是官方文档和 AI 助手均无法告知的隐藏门槛。

（3）最后附上 Hermes 官方快速入门链接：

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

给它起了个昵称“电源先生的小助理”。下一步计划让助手帮忙下单一杯咖啡。