Hermes Agent 调 Grok 模型突然 404,先别急着重装,也别只换 API key。v0.15.0 已加入 xAI 模型退役检测和 hermes migrate xai,用来处理 Grok 旧模型名在退役后继续留在配置里的问题。很多 404 不是账号失效,而是模型 ID 已经不再可用。
先判断是不是模型退役
如果同一个 xAI 凭据还能登录、别的模型能用,只有某个 Grok 模型报 404,就优先怀疑模型名。官方 release 提到 Hermes 会在 doctor 和聊天启动时检测退役模型,并提供迁移命令。这个场景下继续刷新 token、重填 key,通常解决不了。
处理顺序
- 先运行
hermes doctor,看是否提示 xAI 模型已退役或需要迁移。 - 执行
hermes migrate xai,让 Hermes 把旧模型配置迁到支持中的模型。 - 再用
hermes model查看当前 provider 和模型,确认没有继续指向旧 ID。 - 如果你用了
hermes proxy或外部工具,也同步检查它们的模型名。
最容易漏的是第三方前端或脚本。你可能已经把 Hermes 主配置迁好了,但 Open WebUI、Aider、Cline、Continue 这类客户端还在请求旧模型名,于是看起来像 Hermes 仍然坏着。
什么时候才查凭据
如果所有 xAI 请求都失败,才继续查 OAuth、XAI_API_KEY、base_url 和网络。单模型 404 先查模型名;全部 401 或 403 再查授权;连接超时再查代理和网络。按这个顺序排查,能少走很多弯路。