Hermes Agent v0.19.0官方不支持原生Windows，必须在WSL2中安装；若未启用WSL2或未正确进入Ubuntu终端（提示符为ubuntu@DESKTOP-XXX:~$），所有安装操作均无效；推荐使用免配置安装包或在WSL2 Ubuntu 24.04中补全python3.11及相关依赖后执行官方脚本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Windows装Hermes Agent v0.19.0失败不是操作失误，而是官方明确不支持原生Windows环境，所有报错（如“hermes: command not found”、卡在curl阶段、Python版本冲突、401认证失败）都源于跳过了WSL2这一强制前置环节；直接在PowerShell或CMD里运行install.sh/install.ps1，90%会静默中断或报语法错误。
先确认你是否真在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环境。
用一键整合包绕过全部依赖问题
方法一：直接下载免配置安装包
访问 https://hm.ikidi.top/api/download/package/55?promoCode=IVE196E954AB → 选择Windows版 → 下载完成后用7-Zip解压到纯英文路径（如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
