Hermes telegram gateway

---\ntitle: Hermes Telegram Gateway\ncreated: 2026-04-08\nupdated: 2026-04-08\ttype: concept\ttags: [hermes, telegram, bot, messaging, integration]\nsources: []\n---\n\n# Hermes Telegram Gateway\n\n## Überblick\nDer Hermes Telegram Gateway ermöglicht die Interaktion mit dem Hermes AI Agent über Telegram. Dadurch können Befehle gesendet und Antworten empfangen werden, ohne direkt auf das Terminal zugreifen zu müssen.\n\n## Voraussetzungen\n- Funktionsfähiger Hermes AI Agent\n- Telegram-Bot-Token (von @BotFather erhalten)\n- Zugang zum Server, auf dem Hermes läuft\n- Optional: Einrichten eines Webhooks oder Long-Polling\n\n## Konfiguration\n\n### 1. Bot-Token erhalten\n- Neue Bot über @BotFather erstellen oder bestehenden verwenden\n- Token notieren (Format: 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ)\n\n### 2. Umgebungsvariablen setzen\nDas Token muss Hermes bekannt gemacht werden. Dies kann über:\n\nbash\nexport TELEGRAM_BOT_TOKEN=\"dein-token-hier\"\n# Oder in einer .env-Datei für permanente Speicherung\n\n\n### 3. Chat-ID ermitteln\nUm Nachrichten an einen bestimmten Chat zu senden (oder um Hermes zu erlauben, nur von bestimmten Chats akzeptiert zu werden):\n\n- An den Bot eine Nachricht senden\n- Die Chat-ID über die Telegram API abrufen:\n bash\n curl https://api.telegram.org/bot<TOKEN>/getUpdates\n\n- Die Chat-ID erscheint im Feld chat.id des Ergebnisses\n\n### 4. Hermes konfigurieren\nIn der Hermes-Konfiguration (typischerweise in ~/hermes/config.yaml oder über Umgebungsvariablen):\n\nyaml\ntelegram:\n enabled: true\n bot_token: ${TELEGRAM_BOT_TOKEN}\n authorized_chat_ids:\n - 6107594689 # Ersetze mit deiner Chat-ID\n use_webhook: false # Setze auf true für Webhook-Modus\n webhook_url: "" # Bei Webhook-Modus: deine HTTPS-Endpunkt-URL\n\n\n## Funktionsweise\n\n### Long-Polling (Standard)\n- Hermes fragt periodisch die Telegram-API nach neuen Nachrichten ab\n- Einfacher zu einrichten, benötigt keine öffentliche URL\n- Leicht höhere Latenz abhängig vom Polling-Intervall\n\n### Webhook-Modus (Alternative)\n- Telegram sendet POST-Anfragen an deine URL, wenn neue Nachrichten eintreffen\n- Erfordert öffentlich zugängliche HTTPS-URL mit gültigem Zertifikat\n- Geringere Latenz, aber komplexeres Setup\n\n## Nutzung\nNach erfolgreicher Einrichtung:\n\n### Nachrichten senden\n- Sende eine Nachricht direkt an den Bot\n- Hermes verarbeitet sie und antwortet im selben Chat\n\n### Befehle ausführen\n- Alle normalen Hermes-Befehle funktionieren:\n - /wiki suchbegriff – Suche im Wiki\n - /terminal ls -la – Führe einen Terminal-Befehl aus\n - /memory add ... – Speichere Informationen im Gedächtnis\n - /skill view fal-ai-image-generation – Lade eine Fähigkeit\n\n### Antworten erhalten\n- Hermes antwortet im selben Telegram-Chat\n- Lange Antworten werden ggf. aufgeteilt oder als Datei angehängt\n- Fehler und Fehlermeldungen werden klar kommuniziert\n\n## Fehlerbehebung\n\n### Keine Antwort vom Bot\n- Prüfen: Läuft der Hermes-Prozess?\n- Logs auf Fehler bei der Telegram-Verbindung untersuchen\n- Bot-Token korrekt gesetzt?\n- Ist die Chat-ID in der autorisierten Liste?\n\n### „Unauthorized“-Fehler\n- Die sendende Chat-ID ist nicht in authorized_chat_ids aufgelistet\n- Füge die Chat-ID der Konfiguration hinzu und starte Hermes neu\n\n### Webhook-Probleme\n- Stelle sicher, dass die Webhook-URL öffentlich erreichbar ist\n- Überprüfe das SSL-Zertifikat (self-signed Zertifikate werden oft abgelehnt)\n- Prüfe, ob der Port (meist 443) erreichbar ist\n\n## Siehe auch\n- hermes-ai-agent — Der KI-Agent der dieses Gateway nutzt\n- openclaw-telegram-setup — ähnliche Einrichtung für OpenClaw\n- telegram-bot-to-bot-communication — Bot-zu-Bot-Kommunikation\n\n---\nLetzte Änderung: 2026-04-08