Hermes Agent 安装失败
常见现象
hermes: command not found、setup 不继续、依赖缺失、Windows 路径混乱。
先检查
新开终端后运行 which hermes、git --version、python3 --version、node --version。
进入教程先按搜索词判断入口
不要在一个报错里同时改模型、配置、Gateway 和工作流。先锁定现象，再按对应页面做最小复现。
Hermes Agent 安装失败
安装失败、命令找不到或 setup 卡住
先确认终端、PATH、Git、curl、Python、Node 和系统路线，再检查 Provider。
hermes command not found
命令找不到、PATH 没生效
确认安装环境、shell 配置、PATH 和 WSL2 / PowerShell 是否混用。
OpenRouter model not found
OpenRouter 报 model not found
从模型名、Provider、API Key、环境变量和会话重启逐项排查。
OpenRouter 401 / 429
API Key 失效、额度不足或限流
401 先查 Key 和 Provider，429 先查额度、限速和工作流触发频率。
hermes skills install
Skills 安装命令和使用顺序
先 browse 和 search，再 install；会话内安装用 /skills install，后续用 update。
Skills 装完不生效
Skill 不触发、搜索不到或输出不稳定
检查 Skill 目录、会话重启、When to Use 和低风险测试样例。
Hermes Agent Gateway 不回复
Gateway 不回复或消息平台无响应
先分清消息有没有进入 Hermes，再看模型调用和后台日志。
Gateway Token / Chat ID
Token、允许名单或 Chat ID 配错
Token 有效不代表 Gateway 可用，还要确认回调、群 ID、允许名单和进程配置。
Memory vs Skills
Memory 和 Skills 到底怎么分工
Memory 记录稳定事实和偏好，Skills 沉淀可复用步骤和工具调用。
hermes command not found
常见现象
安装后输入 hermes 仍然提示 command not found。
先检查
运行 echo $SHELL、which hermes、printf '%s\n' "$PATH"。
进入教程OpenRouter model not found
常见现象
模型列表里能看到，但运行工作流或 Gateway 时提示 model not found。
先检查
先运行 hermes model、hermes model list、hermes config check、hermes doctor。
进入教程OpenRouter 401 / 429
常见现象
返回 invalid key、unauthorized、rate limit、timeout 或频繁失败。
先检查
运行 hermes model、hermes config check，并用短问答测试 Provider。
进入教程hermes skills install
常见现象
不知道该装哪个 Skill，或者装完后不清楚怎么验证。
先检查
先运行 hermes skills browse，再用 hermes skills search 搜具体能力。
进入教程Skills 装完不生效
常见现象
安装后会话里不触发，或者每次都需要额外解释。
先检查
运行 hermes skills browse、hermes skills search <keyword>，再重启会话。
进入教程Hermes Agent Gateway 不回复
常见现象
Telegram、飞书、企业微信等消息平台能发消息，但 Agent 没有回复。
先检查
先看 Token、允许名单、Chat ID、gateway status 和最近日志。
进入教程Gateway Token / Chat ID
常见现象
机器人在群里，但 /status、短问答或日报任务没有回复。
先检查
检查 Token、Webhook、允许名单、Chat ID、群 ID 和 gateway status。
进入教程Memory vs Skills
常见现象
不知道该把项目规则写进 Memory，还是把流程做成 Skill。
先检查
问自己：这是稳定事实，还是可重复执行的方法？
进入教程恢复路线
排查完以后，用 Starter 包跑一次最小闭环
报错修好不等于工作流稳定。建议再用免费 Starter 包里的日报、Issue 分类或内容选题模板跑一次，确认输入、输出和日志都可复现。