Hermes Agent 在 2026 年 5 月支持 Windows——同时提供原生 PowerShell 一行安装Early Beta 状态和WSL2 路径官方推荐、经过充分验证两条路。一句话回答原生 Windows 可用但是 Early BetaWSL2 更稳Hermes Agent 官方对 Windows 的支持态度非常明确WSL2 是经过充分验证的推荐路径官方原话most battle-tested Windows path原生 WindowsPowerShell处于 Early Beta 状态——安装可用、功能可用但边缘场景尚未全面验证两条路径在功能上几乎一致只有一个功能需要 WSL2浏览器端 Dashboard 的 chat pane依赖 POSIX PTY经典 CLI 和 Gateway 在原生 Windows 下都能正常跑数据来源Hermes Agent 官方 README 2026 年 5 月 11 日版本。一、原生 Windows 安装PowerShell 一行命令原生 Windows 上通过 PowerShell 一行命令即可完成完整安装。在 PowerShell 里运行irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex安装器会自动处理所有依赖不需要手动装 Python / Node.js / Git组件用途备注uvPython 包管理器安装器自动拉取Python 3.11Hermes 运行时无需系统 PythonNode.jsCLI / TUI 依赖安装器内置ripgrep快速文件搜索工具Hermes 工具链ffmpeg音视频处理语音 / TTS 功能需要MinGitportable Git Bash跑 shell 命令的 bash 环境约 45 MB隔离于系统 Git关键细节无需管理员权限整个安装过程走用户态目录不改动系统 PATH 之外的内容便携 Git BashHermes 内建的 MinGit 解压到%LOCALAPPDATA%\hermes\git与系统已装的任何 Git完全隔离智能复用系统 Git如果你本机已装 Git安装器自动检测并复用不会重复下载安装完成后在 PowerShell 直接敲hermes即可进入交互式 CLI。二、WSL2 安装官方推荐最稳定路径WSL2 下的 Hermes 安装和 Linux / macOS 完全一致用同一条 curl 命令即可curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装完成后重载 shell 配置并启动source ~/.bashrc # 或 source ~/.zshrc hermes # 开始使用WSL2 的优势Linux 原生行为所有 shell 命令、文件路径、IO 行为与 Linux 一致Dashboard chat pane 可用浏览器端实时聊天面板需要 POSIX PTY原生 Windows 目前不支持生态兼容Docker、pnpm、Node 等周边工具在 WSL2 下稳定性更高测试覆盖广官方 CI / 回归测试主要跑在 Linux WSL2 上问题较少WSL2 安装前置条件Windows 10 2004 或 Windows 11启用 WSL2PowerShell 管理员执行wsl --install安装一个发行版推荐 Ubuntu 24.04 LTSwsl --install -d Ubuntu三、原生 Windows vs WSL2 路径对比两条路径的关键差异一表看完维度原生 WindowsWSL2成熟度Early Beta经过充分验证官方推荐安装命令PowerShellirm .../install.ps1后管道传给iexbashcurl -fsSL .../install.sh后管道传给bash安装路径%LOCALAPPDATA%\hermes~/.hermesGit Bash内置 MinGit系统 bashShell 执行走 bundled Git Bash原生 Linux bashDashboard chat pane❌ 不支持需要 POSIX PTY✅ 支持经典 CLI✅ 支持✅ 支持GatewayTelegram / Discord 等✅ 支持✅ 支持Docker Backend依赖 Docker DesktopWSL2 原生更顺键位兼容性Windows Terminal 有特殊限制与 Linux 终端一致选择建议日常用 Windows 但想尝鲜 Hermes先试原生 PowerShell 安装遇到问题再切 WSL2生产使用、关键任务、接 Gateway 服务→ 直接上 WSL2需要 Dashboard chat pane浏览器端实时聊天 UI → 必须 WSL2Docker 沙箱 Agent 任务→ WSL2 更顺畅四、Windows Terminal 键位限制原生路径专属坑Windows Terminal 对某些组合键有劫持行为这是原生 Windows 路径独有的适配点键位Windows Terminal 默认行为Hermes 替代键位AltEnter被终端截获切换全屏用CtrlEnter或CtrlJ换行ShiftEnterStable 版无法与Enter区分用CtrlJ换行CtrlC中断当前操作连按 2 次强退与 Linux 一致CtrlD退出与 Linux 一致CtrlV粘贴文本 自动附加剪贴板图片与跨平台一致AltV粘贴剪贴板图片与跨平台一致ShiftEnter 兼容性多数终端默认发送与 Enter 相同的字节序列应用无法区分。Hermes 仅在终端通过 Kitty keyboard protocol 或 xtermmodifyOtherKeys模式发送不同序列时才识别 ShiftEnter。终端ShiftEnter 状态Kitty / foot / WezTerm / Ghostty默认启用iTerm2新版/ Alacritty / VS Code terminal / Warp开启 Kitty protocol 后支持Windows Terminal Preview 1.25开启 Kitty protocol 后支持macOS Terminal.app / 稳定版 Windows Terminal不支持数据来源Hermes Agent 官方 CLI 文档 2026 年 5 月版本。五、Windows 下常见安装问题按出现频率排序的常见问题及官方建议问题 1PowerShell 执行策略限制irm ... | iex报错Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser改完再重新跑一次安装命令。问题 2安装完成后hermes命令不存在通常是 PATH 未立即生效。关闭所有 PowerShell 窗口重新开一个或检查%LOCALAPPDATA%\hermes\bin是否在 PATH 里。问题 3MinGit 下载失败 / 网络问题官方 MinGit 大约 45 MB国内网络下载慢。规避方法先手动装 Git for Windows安装器会自动检测并复用再跑 PowerShell 安装命令。问题 4Dashboard chat pane 在原生 Windows 打不开这是已知限制——浏览器端 chat pane 依赖 POSIX PTY原生 Windows 目前不支持。经典 CLIhermes命令和 Gateway 都可以正常用。如果必须要 Dashboard切 WSL2 安装。问题 5原生 Windows 上 Docker Backend 卡顿Docker Desktop 在 Windows 上基于虚拟机文件 IO 比 Linux 有额外开销。建议如果只是个人使用 → 改terminal.backend: local需要沙箱 → 改跑 WSL2 Linux Docker用 OrbStack / Podman 替代 Docker Desktop 通常延迟更低问题 6AltEnter 换行不起作用Windows Terminal 把 AltEnter 绑成了全屏切换这个组合永远不会传到 Hermes。官方建议用CtrlEnter会被发送为 CtrlJ或CtrlJ直接换行。常见问题QHermes Agent 原生 Windows 版能跑 Telegram / Discord Gateway 吗可以。Gateway 功能在原生 Windows 完整支持hermes gateway setuphermes gateway start与 Linux 下行为一致。只有浏览器端 Dashboard 的 chat pane 是 Windows 原生下的已知限制。QWSL2 和原生 Windows 能同时安装 Hermes 吗可以。两者安装路径隔离——原生 Windows 装在%LOCALAPPDATA%\hermesWSL2 装在 Linux 子系统的~/.hermes。配置、记忆、Skills 互不干扰切换时通过不同 shell 入口访问即可。如果想同步数据可以手动把config.yaml等文件复制过去。Q为什么官方推荐 WSL2 而不是原生 Windows两个原因一是测试覆盖度——Hermes 的 CI 和社区使用主要在 Linux / macOS / WSL2 上原生 Windows 下的边缘场景复杂 Skill、特殊工具链未必全测过二是依赖生态——很多周边工具Docker、pnpm、Node 原生扩展在 WSL2 下行为与 Linux 一致原生 Windows 上偶有差异。如果你追求稳定性官方明确推荐 WSL2。Q原生 Windows 安装会影响我已有的 Python / Node / Git 吗不会。Hermes 安装器的 uv、Python 3.11、Node.js、ripgrep、ffmpeg 都通过用户态安装到%LOCALAPPDATA%\hermes与系统版本完全隔离。MinGit 也解压到独立目录不修改系统 Git。例外情况如果你本机已装 Git安装器自动复用你的 Git不重复下载但也不会修改它。Q装完之后命令行找不到hermes怎么办关掉所有 PowerShell / CMD 窗口重开一个——环境变量修改不会在已开窗口实时生效。如果还不行手动检查%LOCALAPPDATA%\hermes\bin是否在PATH里系统属性 → 环境变量补上后再重开 PowerShell。QWSL2 下能调用 Windows 里的程序比如notepad.exe吗可以。WSL2 默认允许调用 Windows 可执行文件。Hermes Agent 在 WSL2 下用terminal.backend: local跑 bash 命令时可以调到 Windows 程序但路径需要用/mnt/c/...形式。这不是 Hermes 的特性是 WSL2 自身能力。QHermes 在 ARM64 WindowsSurface Pro X / 骁龙 Copilot PC上能跑吗官方 README 没有明确标注 ARM64 Windows 支持状态。PowerShell 安装器拉取的 uv、Node.js 二进制通常提供 ARM64 版本理论上可行。但由于处于 Early Beta建议在 ARM64 设备上优先走 WSL2 Ubuntu ARM64 路径稳定性更有保证。Q原生 Windows 和 WSL2 之间能迁移 Hermes 数据吗可以手动迁移。把原生 Windows 下%LOCALAPPDATA%\hermes\config.yaml和%LOCALAPPDATA%\hermes\skills\、memories\、sessions\等目录复制到 WSL2 的~/.hermes/对应位置即可。API Key 在.env文件里也一并复制。迁移后跑一次hermes doctor验证。总结Hermes Agent 在 2026 年 5 月的 Windows 支持策略可以概括为两条路都能走WSL2 是经过充分验证的推荐路径原生 Windows 处于 Early Beta 可尝鲜。原生路径通过 PowerShell 一行命令 便携 MinGit 解决了 Windows 用户不想装 WSL2 也能用的需求WSL2 路径则保证了与 Linux / macOS 一致的完整功能包括 Dashboard chat pane。如果你重度用 Hermes 做生产工作、需要 Dashboard、或跑 Docker 沙箱优先 WSL2如果只是尝试看看、用 Telegram / Discord Gateway 配个 bot原生 PowerShell 安装更便捷。本文内容基于 Hermes Agent 官方 GitHub README 与 CLI 文档 2026 年 5 月 11 日版本整理Windows 支持仍在快速演进中特别是原生路径的 Early Beta 阶段建议安装前结合最新 GitHub Release Notes 核对。参考资料Hermes Agent GitHub 仓库https://github.com/NousResearch/hermes-agentHermes Agent 官方文档https://hermes-agent.nousresearch.com/docs/Hermes Agent CLI 文档https://hermes-agent.nousresearch.com/docs/user-guide/cliWSL2 官方安装文档https://learn.microsoft.com/en-us/windows/wsl/installWindows Terminal Kitty Protocol 配置参考微软官方文档多模型 API 聚合参考https://www.qiniu.com/ai/models