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

先确认你在哪个环境

`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 里运行。两个环境的路径不同，命令不会自动共享。

where hermes
wsl which hermes

新手建议固定一个路线：优先 WSL2。进入 Ubuntu 终端后再安装、setup 和运行模板。

不要先改 Provider

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

恢复后做一次验收

hermes --version
hermes doctor
hermes setup

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

下一步

如果你还没有真实场景，可以先领取 Free Starter 模板包，从每日简报、Issue 分类和内容选题三个低风险任务开始。