---
title: Troubleshooting
description: "Troubleshooting guides for common Hermes Agent, provider, auth, and channel integration errors."
canonical: "https://deploy-hermes.com/troubleshooting"
---

# Troubleshooting

> Troubleshooting guides for common Hermes Agent, provider, auth, and channel integration errors.

Canonical: https://deploy-hermes.com/troubleshooting

These pages are written for real debugging sessions: a visible symptom, the likely causes, and a recovery order that gets you unblocked quickly.

Diagnose faster, fix the right thing first, and get the agent back online.

## Pages in this category

- [Telegram Pairing Issues](/troubleshooting/telegram-pairing-issues): How to troubleshoot Telegram pairing issues with Hermes Agent, from bot tokens to chat targeting and provider validation.
- [Discord Bot Permission Issues: DeployHermes Support Status](/troubleshooting/discord-bot-permission-issues): The current DeployHermes status for Discord chat deployment, retained at the original URL for accurate search guidance.
- [Slack Auth Mismatch: DeployHermes Support Status](/troubleshooting/slack-auth-mismatch): The current DeployHermes status for Slack chat deployment, retained at the original URL for accurate search guidance.
- [OAuth Expiry](/troubleshooting/oauth-expiry): What OAuth expiry symptoms look like in Hermes deployments and how to refresh tokens without chasing the wrong cause.
- [No Output](/troubleshooting/no-output): How to debug a Hermes Agent that appears online but produces no output in response to user prompts.
- [OpenAI 400 Error](/troubleshooting/openai-400-error): How to debug OpenAI 400 errors in Hermes Agent, including malformed requests, model assumptions, and payload issues.
- [Context Overflow](/troubleshooting/context-overflow): How to identify and fix context overflow problems in Hermes Agent workflows before they become cost and reliability issues.
- [WebSocket Payload Too Large](/troubleshooting/websocket-payload-too-large): How to debug WebSocket payload too large errors in Hermes runtimes, terminals, or live-streamed agent features.
- [Fix Grok API Authentication Errors in Hermes Agent](/troubleshooting/grok-api-authentication-errors): Diagnose xAI key rejection, missing provider credentials, and runtime authentication errors in a Grok-backed Hermes Agent.
- [Grok Telegram Bot Not Responding: A Recovery Checklist](/troubleshooting/grok-bot-not-responding): Troubleshoot a Grok-backed Telegram bot that does not reply by checking pairing, runtime state, xAI authentication, and delivery in order.

---

- [Full documentation index](/llms.txt)
- [Complete site text](/llms-full.txt)
- [Developer portal](/developers)
- [OpenAPI contract](/openapi.json)
- [MCP server card](/.well-known/mcp.json)