Hermes Agent 排错教程 应该从哪里开始？
建议先打开「打开教程地图」，按本页的步骤完成最小验证，再阅读相关排错和视频内容。
Topic guide
排错 专题怎么读
先读基础页，再进入问题排查和可复制模板，最后用免费资源包跑一次低风险场景。
- 01从教程地图确认学习阶段
- 02读相关问题排查和实战文章
- 03领取 Starter 包做一次可复现验证
这个专题适合谁
Hermes Agent 排错教程 适合已经有明确问题、想按专题快速找到教程、排错和模板入口的读者。建议先从本页的主线入口开始，再补相关问题和视频。
读完后的验收标准
打开教程地图 看完后，能选择下一篇教程或一个模板做可复现验证。
先检查这三件事
01先读专题主入口，不要直接跳到复杂配置
02从一个低风险样例验证输入和输出
03把遇到的错误归类到安装、模型、Gateway、Skills 或工作流
常见误区
同时改多个变量导致无法复现
只看最终答案，不记录失败原因
忽略权限、日志和人工确认
常见问题
排错 相关问题怎么判断是否已经解决？
打开教程地图 看完后，能选择下一篇教程或一个模板做可复现验证。
读完 Hermes Agent 排错教程 后下一步做什么？
如果还没有真实场景，先下载免费 Starter 包，选择日报、Issue 分类或内容选题这类只读模板跑一次。
读完专题，建议做一次验证
只看教程不够。下载 Starter 包，选一个日报、Issue 分类或内容选题模板跑一次，确认输入、输出和日志都可复现。
// guide
消息平台·更新 2026-06-13·8 分钟阅读
Hermes Agent Gateway Token 和 Chat ID 怎么配置：Telegram、飞书、企业微信
消息平台不回复时，先确认 Bot Token、Webhook、允许名单、Chat ID、群 ID、签名密钥和后台进程是否一致。
// guide
入门·更新 2026-06-13·8 分钟阅读
Hermes Agent 常用命令速查：setup、doctor、model、skills、gateway
整理新手最常用的 Hermes Agent 命令：安装后验收、模型配置、Skills 安装、Gateway 排错和工作流调试。
⌘ api
模型接入·更新 2026-06-13·8 分钟阅读
Hermes Agent OpenRouter 报 model not found 怎么排查
从模型名、Provider、环境变量、会话重启和上下文窗口五个层面排查 OpenRouter 模型不可用问题。
// guide
消息平台·更新 2026-06-13·9 分钟阅读
Hermes Agent Gateway 不回复：Telegram、飞书、企业微信排查清单
消息平台已经配置但 Agent 不回复时，按 Token、允许用户、Chat ID、进程日志和模型调用逐项定位。
// 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 路径逐步恢复。
⌘ api
模型接入·更新 2026-05-19·8 分钟阅读
Hermes Agent OpenRouter 401 和 429 报错：API Key、额度和限流排查
OpenRouter 返回 401、invalid key、429、rate limit 或 timeout 时，按 API Key、环境变量、额度、模型和触发频率定位。
/skills
Skills·更新 2026-05-19·8 分钟阅读
Hermes Agent Skills 装完不生效：触发条件、会话重启和 Skill 目录排查
安装 Skill 后搜索不到、不会触发或输出不稳定时，按 Skill 名称、目录、When to Use、会话重启和低风险测试排查。