Hermes Agent 故障排查教程 应该先看哪一篇？
建议先点击「打开排错清单」，它是本分类的主线入口。主线看完后，再按阅读顺序补相关文章。
Search intent
这个分类解决什么搜索需求
已经遇到报错，需要快速定位原因和恢复最小可用状态。
适合已经遇到安装失败、模型报错、Gateway 沉默、Skill 不生效或工作流失败的用户。
Focus
重点内容
最小可用恢复
命令和环境变量
模型 API 错误
日志、权限和 Gateway 排错
建议阅读顺序
- 01先还原到短问答或 setup 验收
- 02一次只改一个变量
- 03恢复后把原因写进 runbook 或交接记录
读完后怎么验收
能定位失败发生在哪一层
能通过日志复现和恢复
不会同时修改模型、权限、Prompt 和 Gateway
读前先判断
01先恢复到短问答或 setup 验收
02一次只排查安装、模型、Gateway、Skill 或工作流中的一层
03恢复后把原因写进交接记录
常见误区
同时改模型、权限、Prompt 和 Gateway
只截图错误，不保存日志和复现步骤
问题恢复后不记录根因
常见问题
这个分类读完后怎么判断有效？
能定位失败发生在哪一层；能通过日志复现和恢复；不会同时修改模型、权限、Prompt 和 Gateway
如果 故障排查 相关教程看完仍然卡住怎么办？
先把问题缩小到一个可复现样例，记录当前系统、命令、模型、输入、错误日志和预期输出，再回到排错清单逐层定位。
// guide
故障排查·2026-06-13·8 分钟阅读
hermes update 升级失败、卡住、升级后报错怎么办
运行 hermes update 卡在下载、升级中断、或升级后报缺依赖时,按备份留退路、治网络、补依赖、看日志、必要时回退的次序稳妥恢复,不靠反复重装。
// guide
故障排查·更新 2026-06-01·11 分钟阅读
Hermes Agent 常见报错与排查清单
从环境、模型 API、权限、消息平台和工作流设计五个层面定位 Hermes Agent 常见报错，并保存可复用排查记录。
// 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 路径逐步恢复。