Anleitungen

Telegram Bot mit KI verbinden: OpenClaw + Telegram in 10 Minuten

TGTobias Sander

Telegram + OpenClaw: Dein KI-Assistent auf dem Handy

Telegram ist der schnellste Weg, deinen OpenClaw-Agenten zu erreichen. Warum? Die Bot-Erstellung dauert 2 Minuten, es braucht kein QR-Code-Scanning und funktioniert sofort auf Handy und Desktop.

In dieser Anleitung zeigen wir dir, wie du Telegram mit OpenClaw verbindest – in unter 10 Minuten.

Warum Telegram? (Und nicht WhatsApp?)

| Feature | Telegram | WhatsApp | | --- | --- | --- | | Bot-Erstellung | 2 Min. via BotFather | QR-Code + Linking | | Einrichtungs-Aufwand | Minimal | Mittel | | Gruppen-Bots | ✅ Nativ | ⚠️ Eingeschränkt | | Sprachnachrichten | ✅ Transkription | ✅ Transkription | | Desktop-App | ✅ Standalone | ⚠️ Braucht Phone | | Daten-Schutz | E2E bei Secret Chats | E2E Standard |

Empfehlung: Starte mit Telegram zum Testen. Wenn alles läuft, kannst du WhatsApp parallel dazuschalten.

Schritt 1: Telegram Bot erstellen

  1. Öffne Telegram und suche nach @BotFather
  2. Sende /newbot
  3. Wähle einen Namen für deinen Bot (z.B. „Mein KI Assistent")
  4. Wähle einen Username (muss auf „bot" enden, z.B. mein_ki_assistent_bot)
  5. BotFather gibt dir einen API Token – kopiere ihn!
Beispiel Token: 123456789:ABCdefGhIjKlmNOpQrStUvWxYz

Wichtig: Diesen Token sicher aufbewahren. Wer ihn hat, kann deinen Bot steuern.

Schritt 2: Token in OpenClaw eintragen

Variante A: Beim Setup (empfohlen für Ersteinrichtung)

Wenn du openclaw setup ausführst, wähle bei der Messenger-Auswahl Telegram und füge den Token ein.

Variante B: Nachträglich konfigurieren

Falls OpenClaw bereits läuft, sag deinem Agenten einfach:

„Richte Telegram ein. Hier ist mein Bot-Token: [TOKEN EINFÜGEN]"

Der Agent kümmert sich um die Konfiguration.

Variante C: Manuell in der Config

In der OpenClaw-Konfigurationsdatei:

{
  "telegram": {
    "enabled": true,
    "token": "DEIN-BOT-TOKEN-HIER"
  }
}

Schritt 3: Bot starten und Pairing

Nach der Konfiguration startet OpenClaw den Telegram-Bot automatisch. Jetzt musst du dich mit dem Bot verbinden:

  1. Öffne Telegram und suche nach deinem Bot-Username
  2. Sende /start
  3. Der Bot fragt nach einem Pairing Key
  4. Den Pairing Key findest du in der OpenClaw TUI (Terminal-Oberfläche)
  5. Gib den Key in Telegram ein

Fertig! Dein Bot antwortet dir jetzt mit KI-Power.

Schritt 4: Bot absichern

Standardmäßig kann jeder deinem Bot schreiben. Das willst du nicht. So schränkst du den Zugriff ein:

Allowlist erstellen

Sag deinem Agenten:

„Akzeptiere nur Nachrichten von meiner Telegram-ID. Meine ID ist [DEINE ID]."

Deine Telegram-ID findest du über den Bot @userinfobot.

Admin-Rechte setzen

Für fortgeschrittene Setups kannst du verschiedene Berechtigungslevel definieren:

  • Admin: Voller Zugriff auf alle Funktionen
  • User: Kann chatten und grundlegende Tasks ausführen
  • Read-Only: Kann nur Informationen abrufen

Erweiterte Funktionen

Sprachnachrichten nutzen

Wenn du Groq konfiguriert hast, versteht dein Bot Sprachnachrichten. Einfach eine Voice Message senden – der Agent transkribiert sie automatisch und antwortet.

Tipp: Sprachnachrichten sind perfekt für unterwegs. Du sprichst natürlicher und lieferst mehr Kontext als beim Tippen.

Bilder und Dateien senden

Du kannst deinem Bot Bilder, PDFs und andere Dateien senden. Er kann:

  • Bilder analysieren und beschreiben
  • PDFs zusammenfassen
  • Tabelleninhalte extrahieren
  • Screenshots auswerten

Gruppen-Bot

Du kannst deinen Bot zu einer Telegram-Gruppe hinzufügen. Er reagiert dann auf @Mentions oder bestimmte Keywords. Ideal für kleine Teams, die den Agenten gemeinsam nutzen wollen.

Inline-Modus

Im Inline-Modus kannst du den Bot in jeder Chat-Konversation aufrufen – tippe einfach @dein_bot_name gefolgt von deiner Frage. Das Ergebnis wird direkt in den Chat eingefügt.

Telegram vs. WhatsApp: Die Setup-Unterschiede

WhatsApp-Einrichtung (zum Vergleich)

WhatsApp nutzt das WhatsApp Web Protocol. Das Setup ist etwas aufwändiger:

  1. OpenClaw generiert einen QR-Code
  2. Du scannst ihn mit WhatsApp auf deinem Handy
  3. Ähnlich wie WhatsApp Web – dein Handy muss online sein
  4. Session kann nach Updates oder Neustarts ablaufen → erneutes Scannen nötig

Warum Telegram zum Testen besser ist

  • Kein QR-Code nötig
  • Bot läuft unabhängig von deinem Handy
  • Keine Session-Timeouts
  • Separate App (stört nicht deinen privaten WhatsApp-Account)

Häufige Probleme

Bot antwortet nicht

  • Ist OpenClaw (Gateway) gestartet? Check mit systemctl status openclaw
  • Token korrekt? Kein Leerzeichen, vollständig kopiert?
  • Firewall blockiert ausgehende HTTPS-Verbindungen?

Bot antwortet langsam

  • Claude API kann bei hoher Last langsamer sein
  • Überprüfe dein Modell – Haiku ist schneller als Opus
  • Netzwerkanbindung deines Servers prüfen

Pairing Key funktioniert nicht

  • Key ist zeitlich begrenzt – generiere ggf. einen neuen
  • Stelle sicher, dass du mit dem richtigen Bot-Account schreibst

Nächste Schritte nach dem Setup

  1. Soul.md konfigurieren – Gib deinem Bot Persönlichkeit
  2. QMD Skill installieren – Für stabiles Langzeitgedächtnis
  3. Brave Search einrichten – Damit dein Bot im Web recherchieren kann
  4. Heartbeat aktivieren – Proaktive morgendliche Briefings

All das lernst du detailliert in unserer OpenClaw Masterclass.