实际上，在Windows系统上安装Hermes Agent v0.19.0时，许多用户第一步就遇到困难——并非操作失误，而是官方并未提供原生Windows支持。你遇到的各类报错，如“hermes: command not found”、curl命令卡死、Python版本冲突、401认证失败等，通常都指向同一个根源：忽略了WSL2这个强制前置条件。直接在PowerShell或CMD中运行install.sh或install.ps1，大概率会静默中断或直接报语法错误。

因此，如果你确实需要安装，第一步不是寻找教程，而是确认自己是否已在WSL2环境中。推荐的做法：一是使用免配置的整合安装包，二是在WSL2 Ubuntu 24.04中补全python3.11及相关依赖后再执行官方安装脚本。

先确认你是否在WSL2环境下操作

打开PowerShell，输入以下命令：
wsl -l -v
如果没有任何输出，或显示“WSL未安装”“状态：Stopped”，则说明你未进入Linux子系统——后续所有步骤均无效，请立即停止。

如果已安装但状态不是“Running”，请依次执行：
wsl --shutdown → wsl -t Ubuntu（或你的发行版名）→ wsl

终端提示符应显示为 ubuntu@DESKTOP-XXX:~$ 格式，同时 echo $SHELL 的输出应为 /bin/bash 或 /bin/zsh。否则，你只是用PowerShell标签页模拟WSL环境，实际仍在Windows中，所有操作将徒劳无功。

使用一键整合包解决依赖问题

方法一：直接使用免配置安装包
下载Windows版Hermes Agent整合包（可从社区或官方渠道获取），解压到纯英文路径（例如 D:\hermes），然后双击 Hermes.exe 即可启动。省时省力，无需手动配置。

方法二：手动补全关键缺失依赖项（仅适用于WSL2中的Ubuntu 24.04）
执行以下命令：
sudo apt update && sudo apt install -y python3.11 python3.11-venv python3.11-dev ripgrep ffmpeg curl
随后运行官方安装脚本：
curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

注意：Ubuntu 24.04默认未安装 python3.11-venv，若遗漏此包，uv初始化将失败，但报错信息可能显示“Permission denied”，容易误以为是权限问题。请不要被这个假象迷惑。

修复安装后命令不可用的问题

第一步：检查可执行文件是否存在
执行：
ls ~/.local/bin/hermes
如果返回“No such file or directory”，则表示install.sh中途退出，需要删除 ~/.hermes 目录后重新安装。

第二步：强制刷新PATH环境变量
执行：
source ~/.bashrc
如果仍然无效，可手动添加路径：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

第三步：验证并锁定Python版本
执行：
python3 --version
输出必须为 3.11.x。如果显示3.12或3.13，则卸载后重新安装3.11：
sudo apt remove python3 && sudo apt install python3.11 python3.11-venv python3.11-dev
然后执行：
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1

完成以上步骤后，Hermes Agent应该能够正常运行。虽然Windows + WSL2的配置路径有些曲折，但一旦成功，后续使用就会非常流畅。