Hermes Agent 常见报错与排查清单

先看日志，不要先猜

排错的第一步永远是找到完整日志。启动失败看依赖和环境变量；运行失败看输入源和模型返回；推送失败看消息平台权限和网络。

常见问题

• API Key 没有加载到当前运行环境
• 模型额度不足或限流
• VPS 时间不正确导致定时任务错过
• 消息平台 Webhook 过期
• Prompt 没有约束输出格式
• 输入数据为空但没有兜底逻辑

最小复现

把复杂工作流拆成三段：读取输入、调用模型、发送输出。哪一段失败，就只修哪一段。不要在一个巨大的自动化里同时改十个变量。

printenv | grep API
curl -I "$MODEL_API_BASE"

什么时候求助

当你能提供环境、复现步骤、错误日志和期望输出时，别人才能快速帮你定位。只说“不能用”通常无法排查。

下一步

如果你还没有真实场景，可以先领取 Free Starter 模板包，从每日简报、Issue 分类和内容选题三个低风险任务开始。