Hermes Agent 的日志主要看 ~/.hermes/logs/ 和 hermes logs。v0.8.0 把日志集中化后,常见排错不必到处翻:一般先看 errors.log,再看 agent.log,如果是消息平台问题再看 gateway 相关日志。
三个日志入口怎么用
| 入口 | 适合排查什么 |
|---|---|
hermes logs | 快速 tail、过滤最近运行状态 |
errors.log | 启动失败、工具报错、配置结构错误 |
agent.log | 模型调用、工具执行、会话流程 |
| gateway 日志 | Telegram、Discord、Slack、Webhook 收发问题 |
推荐排错顺序
- 先复现问题,不要只凭印象改配置。
- 运行
hermes logs看最近错误。 - 如果是启动阶段就失败,先跑
hermes config check。 - 如果是 gateway 不回消息,看平台 token、allowlist、频道权限和 gateway 日志。
- 如果是模型慢或失败,看 provider、模型名、429/402/认证错误。
哪些日志不要随便贴出去
虽然 Hermes Agent 会做 secrets redaction,但你仍然应该在发给社区或同事前检查一遍,尤其是 URL query、headers、平台 token、私有文件路径和用户 ID。能贴错误类型和最后几十行,就别整份日志全贴。
一个小技巧:改配置前先保存错误日志片段,改完再对比同一任务是否变短、是否少了同类报错。这样比“重装一下试试”更容易找到真正原因。
官方开源地址:https://github.com/NousResearch/hermes-agent;官方文档入口:https://hermes-agent.nousresearch.com/。