bash: hermes: command not found 怎么办：PATH、Shell 和 Windows 排查

先确认你在哪个环境

command not found 不是模型问题，也不是工作流问题。它表示当前终端找不到 hermes 命令。先确认你是在 macOS、Linux、WSL2 还是 PowerShell 里运行。

echo $SHELL
pwd
which hermes
printf '%s\n' "$PATH"

重新加载 shell 配置

安装脚本通常会把路径写进 shell 配置文件，但当前窗口不一定立即生效。

source ~/.zshrc
source ~/.bashrc
which hermes

如果仍然找不到，直接新开一个终端窗口再试。很多时候问题只是旧会话没有读取新 PATH。

检查是否装在另一个环境

Windows 用户最容易遇到这一类：在 PowerShell 安装，在 WSL2 里运行；或者在 WSL2 安装，在 PowerShell 里运行。两个环境的路径不同，命令不会自动共享。

Get-Command hermes
wsl which hermes

注意在 PowerShell 里 where 是 Where-Object 的别名，不会去查 PATH，要用 Get-Command（或 where.exe hermes）。原生 Windows 安装的命令在 %LOCALAPPDATA%\hermes 下，WSL2 里的在 ~/.local/bin。新手建议固定一个路线：原生 Windows 或 WSL2 二选一，在同一个环境里安装、setup 和运行模板。

不要先改 Provider

命令找不到时，不要继续改 API Key、模型名或 Gateway。先让 hermes --version 能返回结果，再进入 Provider 和 Skills 排查。

恢复后做一次验收

hermes --version
hermes doctor
hermes setup

能看到版本号和 doctor 输出后，再继续看 OpenRouter、Memory、Skills 和 Gateway。

还没有真实场景？可以先领取 Free Starter 模板包，从低风险只读任务开始试跑。