Troubleshooting
Diagnose faster, fix the right thing first, and get the agent back online.
These pages are written for real debugging sessions: a visible symptom, the likely causes, and a recovery order that gets you unblocked quickly.
Telegram Pairing Issues
How to troubleshoot Telegram pairing issues with Hermes Agent, from bot tokens to chat targeting and provider validation.
Read guide →TroubleshootingDiscord Bot Permission Issues
How to diagnose Discord bot permission issues when Hermes Agent is present in a server but cannot respond correctly.
Read guide →TroubleshootingSlack Auth Mismatch
How to recover from Slack auth mismatch problems involving tokens, scopes, workspace installs, and stale configuration.
Read guide →TroubleshootingOAuth Expiry
What OAuth expiry symptoms look like in Hermes deployments and how to refresh tokens without chasing the wrong cause.
Read guide →TroubleshootingNo Output
How to debug a Hermes Agent that appears online but produces no output in response to user prompts.
Read guide →TroubleshootingOpenAI 400 Error
How to debug OpenAI 400 errors in Hermes Agent, including malformed requests, model assumptions, and payload issues.
Read guide →TroubleshootingContext Overflow
How to identify and fix context overflow problems in Hermes Agent workflows before they become cost and reliability issues.
Read guide →TroubleshootingWebSocket Payload Too Large
How to debug WebSocket payload too large errors in Hermes runtimes, terminals, or live-streamed agent features.
Read guide →