Hermes 上手实录Windows 装 Agent 框架的三条路我替你踩完了一句话总结Hermes 是目前社区里很火的开源 Agent 框架但 Windows 用户装它有三条路——WSL2官方推荐最稳、原生 PowerShell最快但有兼容性风险、VirtualBox 虚拟机隔离最彻底。本文把三条路的完整命令、耗时、坑点全部摆出来看完直接选不用再翻十篇踩坑文。正文目录问题背景为什么 Windows 装 Hermes 这么费劲三条路线怎么选一张对比表路线一WSL2 Ubuntu推荐路线二原生 PowerShell快速但谨慎路线三VirtualBox 虚拟机隔离党专属装完之后模型、网关、从 OpenClaw 一键迁移故障排除急救箱一句话总结一、问题背景为什么 Windows 装 Hermes 这么费劲Hermes 这类 Agent 框架底层大量依赖 Linux 生态的脚本和工具链。官方给的安装脚本基本是按 Linux/macOS 设计的Windows 用户直接跑轻则缺依赖重则装完起不来。于是问题变成了在 Windows 上怎么优雅地给它造一个接近 Linux的运行环境这就是三条路线的由来——本质上都是解决同一个问题只是隔离程度和上手成本不同。二、三条路线怎么选一张对比表路线稳定性上手成本适合谁WSL2 Ubuntu⭐⭐⭐⭐⭐ 最稳中需重启、约 10-15 分钟大多数人无脑选这个原生 PowerShell⭐⭐⭐ 有兼容性风险最低一条命令只想先尝个鲜、出问题再说VirtualBox 虚拟机⭐⭐⭐⭐ 隔离彻底最高装虚拟机 Ubuntu怕弄脏系统、或要多环境隔离的人我的建议先 WSL2别犹豫。下面把三条路的命令都给你。三、路线一WSL2 Ubuntu推荐第一步管理员身份开 PowerShell开始菜单搜 PowerShell → 右键 → 以管理员身份运行wsl--install-d Ubuntu装完重启电脑打开 Ubuntu设置一个 Linux 用户名和密码。第二步在 Ubuntu 终端里装 Hermescurl-fsSLhttps://res1.hermesagent.org.cn/install.sh|bashsource~/.bashrc安装脚本用了国内镜像加速大陆网络环境直接跑没问题。首次下载 10-15 分钟左右WSL2 本身约占 1-2GB 磁盘。第三步验证 配置模型hermes# 能进交互界面就说明装好了hermes model# 配置模型hermes setup# 初始化配置如果你的机器较老、WSL2 装不上比如功能未开启可以用 DISM 手动启用两个特性再重启dism.exe/online/enable-feature/featurename:Microsoft-Windows-Subsystem-Linux/all/norestart dism.exe/online/enable-feature/featurename:VirtualMachinePlatform/all/norestart四、路线二原生 PowerShell快速但谨慎不想折腾 Linux 子系统普通 PowerShell 一条命令irmhttps://res1.hermesagent.org.cn/install.ps1|iex装完关掉重开 PowerShell让环境变量生效然后验证hermes hermes model⚠️ 注意这条路是快速启动路线部分 Linux 专属依赖在 Windows 原生环境下可能跑不通。装完先跑一遍核心功能再决定要不要换 WSL2。尝鲜可以生产别用。五、路线三VirtualBox 虚拟机隔离党专属想和主系统完全隔离或者电脑不支持 WSL2就上虚拟机装 VirtualBox官网下 7.0.x 版本下 Ubuntu 镜像中科大镜像源有 22.04.5 桌面版 iso国内速度不错新建虚拟机类型 Linux / 版本 Ubuntu (64-bit)内存给4096 MB8G 内存以上无压力硬盘选 VDI 动态分配、20GB 以上放非系统盘挂载镜像虚拟机右键 → 设置 → 存储 → IDE 控制器 → 点光盘图标选 iso → 确定启动安装 Ubuntu进去后先开 SSHsudoaptupdatesudoaptinstallopenssh-server-ysudosystemctlenablesshsudosystemctl startssh装 Hermes在虚拟机 Ubuntu 里sudoaptupdatesudoaptupgrade-ysudoaptinstall-ygitcurlcurl-fsSLHermes 官方安装脚本地址|bashhermes setup hermes chat虚拟机方案还有个额外好处给 VirtualBox 装好增强功能共享剪贴板、自适应分辨率之后虚拟机和 Windows 之间复制粘贴命令毫无障碍。装增强功能如果报错先apt remove --purge virtualbox-guest-*清残留再装build-essential linux-headers dkms依赖后重装一次过。六、装完之后模型、网关、从 OpenClaw 一键迁移Hermes 装好只是能对话接下来三步让它真正可用① 配模型hermes modelhermes setup接上你手头的 APIKimi、GLM、MiniMax、千问都支持。② 接消息网关可选但强烈建议hermes gateway setup# 交互式选平台飞书 / 微信 / Telegram 等hermes gateway run-vv# 启动网关-vv 看详细日志接好之后手机发消息它就能干活——和之前讲的 OpenClaw / WorkBuddy 接入逻辑一个思路。③ 老用户一键迁移如果你已经用 OpenClaw 用出感情了hermes claw migrate配置、技能这些会帮你迁过来不用从头配。④ 多项目隔离一个 Hermes 干多份工用hermes profile开多个环境各玩各的互不污染。七、故障排除急救箱症状处方hermes命令找不到关闭终端重新打开环境变量没刷新WSL2 里执行source ~/.bashrcWSL2 安装卡住/网络报错检查是否管理员权限、是否重启过公司网络可能需要配代理原生 PowerShell 版功能异常别硬修直接换 WSL2 路线一劳永逸虚拟机里装增强功能报错清残留 → 装 build-essential/headers/dkms → 重新挂载安装 → 重启磁盘不够WSL2 至少留 2GB、虚拟机方案至少留 25GB八、一句话总结Windows 装 Hermes 选对路线 两条命令。WSL2 是标准答案PowerShell 是尝鲜答案虚拟机是洁癖答案——三条路我都替你踩过了照着表选就行。装好只是第一步模型、网关、记忆系统下一篇细讲才是 Hermes 的精华所在。Hermes 三种安装方式的完整实操演示每一步的报错和解决都在课程里《OpenClaw 从安装到运行企业级私有化部署与最佳实践》CSDN 程序员研修院 · 保姆级手搓教程 · 含 WorkBuddy / Hermes 等进阶模块 课程直达https://edu.csdn.net/course/detail/41412
