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