Windows 原生安装 Hermes Agent 完整教程（不用 WSL）
Hermes Agent 官方已支持 Windows 原生运行，不再需要 WSL。本文给出从零安装、配置模型、验证运行的完整步骤，并整理 5 个最容易踩的坑。
早期 Hermes Agent 只能跑在 Linux / macOS / WSL2 上，Windows 用户要先折腾一遍 WSL。现在官方已经提供 Windows 原生安装，CLI、gateway、TUI 和工具都能直接跑。
这篇教程带你在 Windows 10/11 上从零装好。
一、环境要求
| 项目 | 要求 |
|---|---|
| 系统 | Windows 10 / 11（64 位） |
| PowerShell | 5.1 或更高（系统自带） |
| 磁盘 | 建议预留 3 GB 以上 |
| 网络 | 能访问 GitHub / PyPI（国内建议配镜像） |
| 权限 | 普通用户即可，不需要管理员 |
⚠️ 官方标注 Windows 原生支持目前是 early beta，遇到问题可以去 GitHub 提 issue。日常使用建议先备份配置。
二、一行命令安装
打开 PowerShell（不是 CMD），执行：
iex (irm https://hermes-agent.nousresearch.com/install.ps1)安装脚本会自动完成：
- 检查环境
- 准备 Python 3.14（Hermes 要求
>=3.14,<3.15） - 准备 Node.js、npm、ripgrep、FFmpeg
- 安装 Python 依赖
- 把
hermes命令加入 PATH
如果系统缺少 Git，脚本会下载一个经过 SHA-256 校验的 Git for Windows 到工具目录，不会污染系统。
💡 国内网络如果卡在下载阶段，可以先设置镜像：
$env:PIP_INDEX_URL = "https://pypi.tuna.tsinghua.edu.cn/simple" $env:npm_config_registry = "https://registry.npmmirror.com"
三、验证安装
关掉当前 PowerShell，重新开一个（让 PATH 生效），然后：
hermes --version看到版本号就说明装好了。
四、配置模型
第一次使用，运行配置向导：
hermes setup如果你想用 Nous Portal（一个订阅覆盖 300+ 模型 + 搜索/生图/TTS/云浏览器），可以直接：
hermes setup --portal它会走 OAuth 登录，自动把 Nous 设为提供商并开启 Tool Gateway。
如果想用自己的 API Key（OpenAI、OpenRouter、DeepSeek 等），在 hermes setup 里选择对应 provider 即可。也可以随时单独改：
hermes model # 选择模型
hermes tools # 配置启用哪些工具五、开始聊天
hermes进入 CLI 后直接说话就行。想换个更好看的界面，可以用 TUI：
hermes tui六、5 个最容易踩的坑
坑 1：中文乱码
Windows 控制台默认编码可能不是 UTF-8。执行一次：
chcp 65001或者把 PowerShell 的默认编码改成 UTF-8。
坑 2：hermes 命令找不到
安装完必须重开终端。如果还不行，检查用户环境变量 Path 里有没有 Hermes 的工具目录。
坑 3：Python 版本冲突
Hermes 要求 Python 3.14。如果你系统里装的是 3.12/3.13，不要手动改，让安装脚本用它自己的隔离环境。强行用系统 Python 装依赖大概率失败。
坑 4：想装成开机自启的网关
Windows 原生模式下，gateway 建议注册成计划任务（Scheduled Task），而不是 Windows 服务。官方文档的 Windows Native Guide 有完整步骤。
坑 5：和 WSL2 版本冲突
原生安装和 WSL2 安装可以共存，但数据目录不同（原生在 Windows 用户目录，WSL 在 Linux home）。别把两边的 ~/.hermes 搞混。
七、卸载 / 重装
官方不建议直接删数据目录来”修问题”。正确做法：
hermes update # 先尝试更新确需重装时，先备份 %USERPROFILE%\.hermes（配置、记忆、技能都在里面），再卸载程序。
八、下一步
装好之后建议继续看：
- 从 OpenClaw 迁移到 Hermes
- 模型接入实战（整理中）
- 微信 / 飞书 / 钉钉对接（整理中）
官方安装文档：https://hermes-agent.nousresearch.com/docs/getting-started/installation Windows 原生指南：https://hermes-agent.nousresearch.com/docs/user-guide/windows-native