Win10系统搭建Hermes Agent全攻略：WSL2一键部署爱马仕AI详解

前言

在 Windows 10 上部署 Hermes Agent（常被称作”爱马仕AI”）是可行的，但不支持原生 Windows 环境运行。官方推荐通过 WSL2（Windows Subsystem for Linux） 搭建 Ubuntu 环境来运行，这是最稳定、兼容性最佳的方案。

---

✅ 推荐部署方案：WSL2 + Ubuntu

前提条件

• Windows 10 版本需为 2004（内部版本 19041）或更高
• 确保已启用虚拟化（任务管理器 → 性能 → CPU，查看”虚拟化”是否启用）

---

步骤一：安装并配置 WSL2

1.1 启用 WSL 功能

以管理员身份打开 PowerShell，执行以下命令：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

执行完成后重启电脑，然后在 PowerShell 中更新 WSL：

wsl --update

1.2 安装 Ubuntu 发行版

执行以下命令，系统会自动完成以下操作：

• 启用 WSL 和虚拟机平台功能
• 下载并安装默认发行版（通常是 Ubuntu）

wsl --install

安装过程中会提示创建默认 Unix 用户账号，输入你想要的账号名（如 administrator）并设置密码即可。如果想使用其他账号名，可以先创建 administrator 账号，后续再删除并创建新账号。

---

步骤二：安装 Git（如未预装）

2.1 检查 Git 状态

git --version

2.2 如未安装，执行以下命令

sudo apt update && sudo apt install git -y

2.3 配置 GitHub 国内加速

git config --global url."https://hub.fastgit.xyz/".insteadOf https://github.com/
git config --global url."https://hub.fastgit.xyz/".insteadOf https://www.github.com/

这两条命令可以将 GitHub 的克隆地址替换为国内加速镜像，大幅提升下载速度。

---

步骤三：安装 Hermes Agent

3.1 一键安装脚本

安装过程约 3~5 分钟，会自动安装 Python 3.11、Node.js 及所有依赖。安装完成后跳出来的第一个问题直接回车即可，然后进入大模型配置环节。

在 Ubuntu 终端中执行：

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

如果下载速度较慢，建议开启代理，使用日本节点的代理速度通常较快。

---

步骤四：初始化并启动 Hermes

4.1 刷新环境变量

source ~/.bashrc

4.2 初始化配置

hermes setup

4.3 启动助手

hermes

首次运行会引导你选择大模型提供商（如 OpenRouter、OpenAI、本地 Ollama 等）并输入 API Key。

如果你购买的是 19 元/月的套餐，选择 2.7 版本即可，无需选择极速版。

---

🚀 其他可选方案（按推荐度排序）

方案一：Docker 容器化部署

适合已有 Docker 环境的用户，环境隔离，避免污染系统。

方案二：PowerShell 脚本安装（社区非官方）

仅建议快速尝鲜，存在兼容性问题，不推荐长期使用。

⚠️ 注意：截至 2026 年 4 月，Hermes Agent 官方仍不支持原生 Windows，所有”原生支持”说法均指通过 WSL2 或容器实现。

---

📌 配置建议（国内用户）

模型推荐

• 使用 OpenRouter（免翻墙、支持 GPT-4/Claude 等多模型）：https://openrouter.ai/

本地模型

• 可搭配 Ollama 部署 Llama3 等本地模型，零成本且隐私安全：https://ollama.com/

中文文档

• Hermes 中文指南：https://www.majiabin.com/hermes

---

🔧 常见问题解决

问题一：hermes: command not found

执行以下命令刷新环境变量，或重启终端：

source ~/.bashrc

问题二：安装卡在 UV 包管理器

手动安装 Python 3.11 后，再重新执行安装脚本。

问题三：WSL2 启动失败

进入 BIOS 检查是否已启用 VT-x/AMD-V 虚拟化选项。