hermes command not found 排查 应该从哪里开始？
建议先打开「打开命令找不到排查」，按本页的步骤完成最小验证，再阅读相关排错和视频内容。
Topic guide
command not found 专题怎么读
先确认命令是否装在当前环境，再重载 shell 配置，最后区分 WSL2 和 PowerShell。
- 01运行 which hermes 和 echo $SHELL
- 02source 对应 shell 配置
- 03确认没有跨环境运行
这个专题适合谁
hermes command not found 排查 适合正在安装、换系统、上 VPS 或排查命令环境的人。这个阶段最重要的是缩小问题范围，先让 CLI 在当前终端稳定工作。
读完后的验收标准
能在当前终端稳定启动 Hermes Agent，短问答和 setup 验收都有明确结果。
先检查这三件事
01确认当前 shell、系统环境和安装路径一致
02先跑 hermes setup、config check 或 doctor 这类验收命令
03把失败日志复制出来，再判断是依赖、PATH、Provider 还是权限问题
常见误区
在 WSL2、PowerShell、macOS 终端之间混用路径
没看日志就反复重装
CLI 还没跑通就直接接 Gateway 或定时任务
常见问题
command not found 相关问题怎么判断是否已经解决？
能在当前终端稳定启动 Hermes Agent，短问答和 setup 验收都有明确结果。
读完 hermes command not found 排查 后下一步做什么？
如果还没有真实场景，先下载免费 Starter 包，选择日报、Issue 分类或内容选题这类只读模板跑一次。
读完专题，建议做一次验证
只看教程不够。下载 Starter 包，选一个日报、Issue 分类或内容选题模板跑一次，确认输入、输出和日志都可复现。
// guide
故障排查·更新 2026-05-19·7 分钟阅读
hermes command not found 怎么办：PATH、Shell 和 Windows WSL2 排查
终端提示 hermes: command not found 时，按安装环境、PATH、shell 配置和 Windows WSL2 路径逐步恢复。