Windows 环境下安装 Hermes：一次从 WSL 2 到模型配置的完整记录

Windows 环境下安装 Hermes一次从 WSL 2 到模型配置的完整记录这篇文章整理自我在 Windows 环境中安装 Hermes 的实际记录。过程里最关键的不是某一条命令而是先把 WSL 2、Ubuntu、Linux 内核更新和 Hermes 配置这些环节串起来。中间我也踩到了一些版本、转换和配置上的坑整理出来供同样使用 Windows 的朋友参考。写在前面为什么要先折腾 WSL 2Hermes 的安装和运行更适合放在 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 版本号达到190318362或更高。如果版本过低建议先通过 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可以先停止正在运行的 Ubuntuwsl--terminate Ubuntu然后执行转换命令wsl--set-versionUbuntu 2最后可以把 Ubuntu 设置为默认分发版wsl--set-defaultUbuntu如果转换过程中仍然有问题可以尝试更新 WSLwsl--update如果无法访问 Microsoft Store也可以使用wsl--update--web-download必要时可先关闭 WSLwsl--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?invitationCode8ACNQG输入模型接口地址和 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 使用都比较顺畅。喜欢的话欢迎点赞关注支持~❤️