故障排查速查
① 'hermes' 不是内部或外部命令
根因:PATH 未生效或用了旧终端 · 解法:新开终端;仍不行用完整路径
| 操作 | 命令 |
|---|
| 完整路径 | "C:\Users\WIN11\AppData\Local\hermes\hermes-agent\venv\Scripts\hermes.exe" gateway status |
② HTTP 503: No available channel for model
根因:nexus 网关模型名不匹配——0731 系列必须带 -chat 后缀(如 deepseek-v4-flash-0731-chat)· 解法:先用 curl 验证,再改任务模型
| 操作 | 命令 |
|---|
| 改模型 | hermes cron edit <job_id> --model deepseek-v4-flash-0731-chat --provider daili |
③ Skipped to prevent unintended spend (drift guard)
根因:cron 任务模型未 pin,全局模型配置变更后任务被跳过 · 解法:显式指定模型与 provider
| 操作 | 命令 |
|---|
| pin 模型 | hermes cron edit <job_id> --model sensenova-6.8-flash-lite --provider daili |
④ 停止 dashboard 报"拒绝访问"
根因:dashboard 进程不允许优雅停止 · 解法:加 /F 强杀
| 操作 | 命令 |
|---|
| 强杀 | taskkill /PID <PID> /F |
⑤ 网关 stop 后又自动复活
根因:计划任务 / 开机自启脚本残留 · 解法:删计划任务 + Startup 里的 Hermes VBS
| 操作 | 命令 |
|---|
| 删 dingtalk2 | schtasks /Delete /TN "Hermes_Gateway_dingtalk2" /F |
| 删默认 | schtasks /Delete /TN "Hermes_Gateway_default" /F |
⑥ 端口 9119 被占用 / dashboard 起不来
根因:已有 dashboard 实例在跑 · 解法:找到 PID 结束即可
| 操作 | 命令 |
|---|
| 找 PID | netstat -ano | findstr :9119 |
| 结束 | taskkill /PID <PID> /F |