Windows 环境下安装 Hermes：一次从 WSL 2 到模型配置的完整记录
这篇文章整理自我在 Windows 环境中安装 Hermes 的实际记录。过程里最关键的不是某一条命令，而是先把 WSL 2、Ubuntu、Linux 内核更新和 Hermes 配置这些环节串起来。中间我也踩到了一些版本、转换和配置上的坑，整理出来供同样使用 Windows 的朋友参考。
写在前面：为什么要先折腾 WSL 2？
Hermes 的安装和运行更适合放在 Linux 环境里。对 Windows 用户来说，最省心的方式通常不是直接在 Windows 上硬装一套环境，而是先把 WSL 2 配好，再通过 Ubuntu 进入 Linux 环境安装 Hermes。
我的整体路径是：
- 检查 Windows 版本是否支持 WSL 2；
- 启用 WSL 和虚拟机平台；
- 安装 WSL 2 Linux 内核更新包；
- 安装并配置 Ubuntu；
- 在 Ubuntu 中执行 Hermes 安装脚本；
- 根据自己的模型服务完成 Hermes 初始化配置。
下面按实际操作顺序展开。
一、检查 Windows 版本并启用 WSL 2 相关功能
首先需要确认 Windows 版本满足 WSL 2 的要求。
按Win + R，输入：
winver回车后查看系统版本号。一般来说，需要 Windows 版本号达到1903（18362）或更高。如果版本过低，建议先通过 Windows 更新升级系统。
确认版本没问题后，以管理员身份打开 PowerShell 或命令提示符，执行下面两条命令：
# 启用“适用于 Linux 的 Windows 子系统”可选功能dism.exe/online/enable-feature/featurename:Microsoft-Windows-Subsystem-Linux/all/norestart# 启用“虚拟机平台”可选功能dism.exe/online/enable-feature/featurename:VirtualMachinePlatform/all/norestart执行完成后，一定要重启电脑。这一步很关键，不重启的话，后面的 WSL 2 设置或 Ubuntu 转换可能会出现各种奇怪问题。
二、安装 WSL 2 Linux 内核更新包
接下来安装微软官方的 WSL 2 Linux 内核更新包。
下载地址：
WSL 2 Linux 内核更新包
安装完成后，建议再次重启电脑，让相关内核更新完全生效。
然后在 PowerShell 或命令提示符中执行：
wsl--set-default-version 2这条命令的作用是：让后续新安装的 Linux 分发版默认使用 WSL 2。
三、处理 Ubuntu 分发版并切换到 WSL 2
如果你已经安装过 Ubuntu，但它当前不是 WSL 2，可以先停止正在运行的 Ubuntu：
wsl--terminate Ubuntu然后执行转换命令：
wsl--set-versionUbuntu 2最后可以把 Ubuntu 设置为默认分发版：
wsl--set-defaultUbuntu如果转换过程中仍然有问题，可以尝试更新 WSL：
wsl--update如果无法访问 Microsoft Store，也可以使用：
wsl--update--web-download必要时可先关闭 WSL：
wsl--shutdown然后再重新执行更新和转换命令。这里要提醒一下，涉及“重置”类操作时要谨慎，因为可能影响已有分发版和其中的数据。
四、安装 Ubuntu，并从开始菜单启动
WSL 2 环境准备好之后，就可以安装 Ubuntu 了。
打开 Microsoft Store，搜索Ubuntu并安装。
安装完成后，在 Windows 左下角开始菜单中找到 Ubuntu。为了减少权限相关的问题，我这里选择以管理员身份运行。
进入 Ubuntu 后，就可以开始安装 Hermes 了。
五、在 Ubuntu 中安装 Hermes
进入 Ubuntu 终端后，执行 Hermes 官方安装脚本：
curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash如果网络不佳，脚本安装不顺利，可以执行这个，使用国内源安装：
curl-fsSLhttps://res1.hermesagent.org.cn/install.sh|bash-x安装过程需要等待一段时间。脚本跑完之后，会进入配置阶段。
** 注意：使用空格进行选择
六、配置模型：我选择了自定义模型
在模型配置这一步，我选择的是自定义模型。你也可以根据自己的情况选择上面列出的其他模型配置。
这里顺带记录一下我的个人选择：我用的是 Routin 平台的模型，整体体验还不错，稳定性和价格都比较友好。
地址：https://routin.ai/register?invitationCode=8ACNQG
输入模型接口地址和 API Key 之后，Hermes 会继续让你选择模型。
我在 Routin 平台使用的是gpt 5.4，而平台对应的模型名称是：
gpt-5.4这里需要注意：配置时最好严格按照平台提供的模型名称填写。随后再配置上下文长度和显示名称。
模型配置完成后，Hermes 基本就可以使用了。后续还有一些消息相关配置，这里就不展开赘述了。
所有内容配置完后，会自动进入 Hermes。
七、安装后的自检与常用维护命令
进入 Hermes 后，如果想退出，可以按：
Ctrl + C退出后建议先执行自检命令：
hermes doctor这个命令可以快速检查配置是否完整，例如 API Key 是否缺失、某些环境问题是否存在等。
如果提示中明确写了可以自动修复，可以继续执行：
hermes doctor--fix如果后续发现还有配置需要补充，可以在 Ubuntu 中执行：
hermes setup它会把整套初始化流程再走一遍，适合重新补配置。
如果你需要查看 Hermes 的运行日志、配置等，可以运行：
hermes dashboard总结：Windows 用户安装 Hermes 的关键点
这次安装下来，我觉得 Windows 环境下安装 Hermes 的重点主要有三个：
先把 WSL 2 配稳定
Windows 版本、虚拟机平台、WSL 功能、内核更新包，这几项最好一次性确认到位。Ubuntu 要明确运行在 WSL 2 上
如果之前安装过 Ubuntu，记得用wsl --set-version Ubuntu 2转换版本，并设置默认分发版。模型配置要严格按平台字段填写
尤其是 API 地址、API Key、模型名称和上下文长度。模型名称不要凭感觉写，最好复制平台给出的标准名称。
整体来看，Hermes 本身的安装脚本并不复杂，真正容易卡住的地方反而是 Windows 到 Linux 环境的准备过程。只要 WSL 2 和 Ubuntu 这部分打通，后面的 Hermes 安装、模型配置、自检和 dashboard 使用都比较顺畅。
喜欢的话，欢迎点赞关注支持~❤️😊
