告别环境配置噩梦：Hermes Agent Windows 三大部署路线实战指南
嗨，我是提米大门的首席选品官提米哥。很多开发者第一次在 Windows 上搭建本地 AI 开发助手时，最头疼的就是环境配不平、命令找不到或者文件系统不兼容。其实只要选对路，几分钟就能让它在你的电脑上乖乖干活。下面我把官方技术文档“翻译”成了大白话，分三种场景教你怎么装、怎么用，保证刚入门的同学也能一次跑通。
🧭 第一步：先想清楚你该走哪条路？
Hermes Agent 支持三种安装方式，选哪个取决于你平时主要写什么代码、用什么工具：
- 如果你做的是 Windows 专属项目（比如用 PowerShell / .NET 写脚本、控制本地硬件、跑 Telegram 或 Discord 网关、处理普通硬盘文件）：直接选原生 PowerShell 或桌面客户端。它们和你的 Windows 系统是“无缝衔接”的。
- 如果你做的是 Linux 生态项目（比如要编译 Linux 程序、跑 Docker、写 Shell 脚本、或者必须用到网页后台的内置聊天终端）：强烈建议装在 WSL2（Windows 的 Linux 子系统）里。因为在纯 Windows 环境下，网页端的聊天窗口因为缺少 Linux 特有的底层支持，是无法使用的。
⚡ 方案一：纯命令行安装（适合习惯用黑框框的老兵）
这种装法不需要管理员权限，它会自动帮你准备好 Python、Node.js、Git 等所有基础工具，完全不会污染你电脑现有的环境。
- 打开普通的 PowerShell 窗口（右键开始菜单即可找到）。
- 粘贴下方命令并回车。它会直接从官方仓库拉取脚本并自动完成配置：
# 从 GitHub 获取官方一键安装脚本，并通过管道交给当前 Shell 执行
iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)
- 脚本跑完后，务必关闭当前的 PowerShell 窗口，再重新开一个。这一步是为了让系统记住新增的环境目录，之后在任何地方输入命令都能直接唤起 Hermes Agent。
- 进阶参数说明详见官方文档指引。
🖥️ 方案二：桌面图形客户端（适合喜欢点鼠标的新手）
如果你不想天天敲代码，想要一个带侧边栏、能看技能树、还能同时跑多个 AI 窗口的可视化界面，这款 Desktop 客户端就是为你准备的。
- 前往官方文档页下载最新安装包。
- 双击运行安装程序。首次启动时，软件会在后台静默完成依赖环境的初始化。
- 如果你已经通过上面的命令行装过一遍，桌面端会自动读取你之前的 API 密钥和历史聊天记录，无缝衔接，不用重复配置。
🐧 方案三：WSL2 环境安装（适合需要 Linux 专属工具的极客）
WSL2 相当于在你的 Windows 里跑了一个轻量级的 Linux 虚拟机，原生支持 Linux 的文件系统和终端协议。
步骤 1：准备 WSL2 底座
以管理员身份打开 PowerShell，输入以下命令一键启用子系统：
# 下载并启用 Windows Subsystem for Linux 核心组件
wsl --install
重启电脑（如果有提示的话），按屏幕提示设置好 Linux 的用户名和密码。接着用下面的命令检查版本：
# 查看已安装的发行版及其版本号，确保 VERSION 列显示为 2
wsl --list --verbose
步骤 2：注入 Hermes Agent
切换到你常用的 Ubuntu 终端，复制粘贴以下命令进行部署：
# 下载官方安装脚本并交由 bash 执行，随后重载环境变量使其立即生效
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
💡 提米哥的避坑提醒：请把你的代码项目和工程文件统统放在 Linux 自己的目录下（比如 ~/projects/），千万不要偷懒把它们存在 Windows 挂载盘（/mnt/c/）里。跨系统互相读文件会导致读写极慢，Git 操作也会卡成 PPT。
🔍 第二步：装好了怎么验证？如何跑通第一次对话？
不同的环境必须在对应的终端里检查。检查完毕后，先别急着让它写代码，先用最轻量的指令测试环境是否健康。
在原生 PowerShell / 桌面端运行：
# 查找 hermes 命令是否存在于当前路径
Get-Command hermes
# 打印当前版本号确认安装成功
hermes --version
# 运行官方自带的诊断工具，检查 git、浏览器内核等依赖是否正常
hermes doctor
在 WSL2 Ubuntu 终端运行：
# 确认命令已在系统中注册
command -v hermes
# 打印当前版本号
hermes --version
# 运行官方自带的诊断工具
hermes doctor
hermes doctor 会帮你核对所有关键依赖的路径。诊断全部绿光后，如果还没绑定 AI 模型，请先运行 hermes setup 选择你的服务商。一切就绪后，输入以下命令开启对话：
# 进入交互模式，开始发送第一条指令
hermes chat
🎯 新手测试技巧：第一条指令千万别让它写文件！随便问个架构概念或知识问答。只要看到流式文字正常滚动、没有乱码或报错，就说明你的 AI 助手已经完全活过来了。
🛠️ 常见问题速查（原故障排查表已转为清单）
如果你在运行过程中踩坑，对照下面这五点找找答案：
- 提示找不到命令
hermes: The term 'hermes' is not recognized：当前窗口还没刷新环境变量。解决方法：关掉终端重开，或者直接双击运行%LOCALAPPDATA%\hermes\bin\hermes.exe。 - 网页后台
/chat标签页报红：原生 Windows 缺乏 Linux 特有的终端机制。解决方法：基础任务管理没问题，但想用网页版内置聊天终端，请必须切到 WSL2 环境。 - 运行脚本报错
WinError 193: %1 is not a valid Win32 application：在 Windows 下调用 Node/npm 工具漏写了后缀。解决方法：显式加上.cmd后缀再运行（例如将npx xxx改为npx.cmd xxx）。 - 命令行输出满屏问号乱码：系统自带旧版控制台不支持现代字符编码。解决方法：改用新版 Windows Terminal，并确保没有错误设置禁止 UTF-8 的环境变量。
- WSL 里面跑
git status巨卡无比：项目文件夹放在了 Windows 共享盘（如/mnt/c/...）。解决方法：把仓库迁到 Linux 系统的主目录（如~/code/...），利用原生文件系统性能会瞬间起飞。
