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

Direkte Antwort: Du verbindest Telegram mit OpenClaw in vier Schritten: 1. Bot via @BotFather erstellen und API-Token kopieren. 2. Token in OpenClaw eintragen (Setup-Wizard, Agent-Befehl oder Config-Datei). 3. Bot mit /start ansprechen und Pairing-Key eingeben. 4. Allowlist setzen, damit nur deine Telegram-ID Zugriff hat. Das ganze Setup dauert unter 10 Minuten und ist einsteigerfreundlich, weil weder QR-Code-Scan noch Phone-Linking nötig sind.

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 es funktioniert sofort auf Handy und Desktop.

In dieser Anleitung zeigen wir dir, wie du Telegram mit OpenClaw verbindest, in unter 10 Minuten. Inklusive Allowlist-Konfiguration, Voice-Setup, Gruppen-Bots und Troubleshooting.

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 | | API-Stabilität | Sehr hoch | Mittel (Web-Protokoll) | | Bot-Ökosystem | Riesig | Klein |

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. Im Workspace landet er später in .secrets/telegram-bot.txt.

Bot-Profil verschönern (optional, aber sinnvoll)

Über @BotFather kannst du:

• /setname: Anzeigename ändern
• /setdescription: Beschreibung setzen ("Mein persönlicher KI-Assistent, läuft auf eigenem Server.")
• /setabouttext: Über-Text
• /setuserpic: Profilbild hochladen
• /setcommands: Slash-Befehle definieren (z. B. /today, /tomorrow, /help)

Das Profil wirkt sofort professioneller und du erkennst deinen Bot leichter in der Telegram-App.

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 und schreibt den Token in die richtige Datei.

Variante C: Manuell in der Config

In der OpenClaw-Konfigurationsdatei:

{
  "telegram": {
    "enabled": true,
    "token": "DEIN-BOT-TOKEN-HIER",
    "allowlist": ["123456789"],
    "voice": {
      "enabled": true,
      "provider": "groq"
    }
  }
}

Token am besten nicht direkt einfügen, sondern als Pfad-Referenz auf .secrets/telegram-bot.txt. Mehr zu Secrets-Management findest du im Glossar unter Identity-File.

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) oder per openclaw pairing-key auf der Konsole
5. Gib den Key in Telegram ein

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

Wenn du mehrere Geräte verbinden willst (Handy plus Desktop-App auf demselben Telegram-Account): kein neuer Pairing nötig, Telegram syncronisiert das automatisch.

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.

In der Konfiguration sieht das so aus:

"allowlist": ["123456789", "987654321"]

Mehrere IDs heißt: mehrere User dürfen den Bot nutzen (z. B. du selbst plus Partner oder Team-Mitglieder).

Admin-Rechte setzen

Für fortgeschrittene Setups kannst du verschiedene Berechtigungslevel definieren:

• Admin: Voller Zugriff auf alle Funktionen, kann Skills installieren, Konfiguration ändern
• User: Kann chatten und grundlegende Tasks ausführen
• Read-Only: Kann nur Informationen abrufen, keine Tools aktivieren

In AGENTS.md verankerst du das so:

## Berechtigungen
- 123456789: admin (Inhaber, alles erlaubt)
- 987654321: user (Standardzugriff, keine Skill-Installation)
- 555000111: read-only (nur Reports lesen, keine Aktionen)

Notfall-Sperre

Wer schnell den Bot stillschweigend abschalten will: systemctl stop openclaw reicht. Oder über @BotFather mit /setbotlinks den Bot deaktivieren.

Erweiterte Funktionen

Sprachnachrichten nutzen

Wenn du Groq oder ein anderes Whisper-API-kompatibles Backend 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. Beim S-Bahn-Pendeln, in der Kaffeepause oder beim Spaziergang.

DSGVO-Hinweis Voice

Voice geht je nach Setup an einen Cloud-Anbieter (z. B. Groq, OpenAI). Für sensible Inhalte besser Text nutzen oder ein lokales Whisper-Setup. Mehr dazu im Beitrag DSGVO-konforme KI-Agenten.

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
• Quittungen und Belege erfassen

Praktisch: Quittung am Mittagstisch fotografieren, an den Bot schicken, "buche das auf Spesen Q2", fertig.

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, etwa für interne Recherche, Briefing oder als gemeinsame Inbox.

Wichtig im Gruppenkontext: Privacy Mode in @BotFather aktivieren (/setprivacy -> Disable, sonst sieht der Bot nur direkte @Mentions). Allowlist greift trotzdem auf Channel-Ebene.

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.

Praktisch für: schnelle Übersetzungen, Faktencheck im Chat mit Kollegen, Adressen suchen während eines Gesprächs.

Slash-Commands

Wer regelmäßig dieselben Aufgaben triggert, definiert Slash-Commands über @BotFather:

/today - Tagesbriefing für heute
/tomorrow - Vorschau auf morgen
/inbox - Posteingang triagieren
/log - Tagesabschluss schreiben
/help - Übersicht aller Befehle

Diese Commands werden in der Telegram-Tastatur als Vorschläge angezeigt und sind ein riesiger UX-Boost.

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)
• Deutlich stabilere offizielle API
• Gruppen-Bots out of the box

Wer WhatsApp dazuschalten will: schnell sein, technisch ist es robust, aber die WhatsApp-Web-Protocol-Anbindung ist eine Eigenleistung von OpenClaw und kann bei größeren WhatsApp-Updates kurz hängen.

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?
• Allowlist enthält deine ID? userinfobot zur Kontrolle

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
• Workspace-Kontext zu groß? Memory rotieren

Pairing Key funktioniert nicht

• Key ist zeitlich begrenzt, generiere ggf. einen neuen
• Stelle sicher, dass du mit dem richtigen Bot-Account schreibst
• Bot wirklich gestartet? journalctl -u openclaw -f

Sprachnachrichten werden nicht transkribiert

• Voice-Provider in Config aktiviert?
• API-Key gültig?
• Audio-Format okay (Telegram liefert OGG, das kann OpenClaw direkt verarbeiten)

Bot reagiert auf jeden in der Gruppe

• Privacy Mode aktivieren via @BotFather: /setprivacy -> Enable
• Allowlist-Logik prüfen, in Gruppen kann auch der Channel-Owner als ID auftauchen

"Unauthorized" 401-Fehler

• Token wurde versehentlich rotiert oder gelöscht
• Bei BotFather mit /revoke neuen Token holen, in Config einfügen, Service neu starten

Nächste Schritte nach dem Setup

1. Soul.md konfigurieren: Gib deinem Bot Persönlichkeit. Mehr im Beitrag Das perfekte OpenClaw-Setup.
2. QMD Skill installieren: Für stabiles Langzeitgedächtnis. Details im Beitrag 10 Skills für Selbstständige.
3. Brave Search einrichten: Damit dein Bot im Web recherchieren kann. Eine DSGVO-freundliche Alternative zu Google Search.
4. Heartbeat aktivieren: Proaktive morgendliche Briefings. Glossar-Eintrag: Heartbeat.
5. Allowlist erweitern: Falls Familie oder Team mit nutzen sollen.
6. Slash-Commands setzen: UX deutlich verbessern.

All das lernst du detailliert in unserer OpenClaw Masterclass, insbesondere in Modul 4: Skills installieren und Modul 5: DSGVO und Sicherheit.

Sicherheitsempfehlungen für Telegram-Bots

Telegram ist solide, aber kein Wundermittel. Empfohlene Härtung:

• Allowlist immer setzen, nie ohne Schutz online lassen.
• Token rotieren, wenn er versehentlich geleakt wurde (BotFather /revoke).
• Logs prüfen, ungewöhnliche IDs oder Anfragen erkennen.
• Rate Limiting auf OpenClaw-Seite (einstellbar in Config).
• DSGVO: in der Datenschutzerklärung erwähnen, dass Telegram als Auftragsverarbeiter genutzt wird.
• Nicht zu viele Admin-User, jeder Admin darf alles und kann Konfigurationen ändern.

FAQ: Telegram + OpenClaw

Brauche ich ein Telegram-Premium-Konto?

Nein. Bots laufen auf der normalen Bot-API, völlig unabhängig vom User-Premium-Status.

Kann ich denselben Bot für mehrere OpenClaw-Workspaces nutzen?

Nein, ein Bot-Token ist fest an einen Bot gebunden, ein Bot kann nur einen Webhook bzw. Long-Polling-Empfänger haben. Lösung: pro Workspace einen eigenen Bot anlegen, Bot-Username einfach mit Suffix versehen (z. B. _test_bot, _prod_bot).

Was, wenn Telegram in meinem Land blockiert wird?

Bot funktioniert weiter, solange der Server Telegram-Endpoints erreichen kann. Auf User-Seite hilft VPN. Notfalls auf alternative Messenger umstellen.

Kann ich vom Bot selbst Nachrichten an mich senden lassen?

Ja, das ist sogar einer der wertvollsten Use-Cases. Heartbeat triggert eine Tagesbriefing-Nachricht, der Agent sendet sie aktiv an deine ID. Voraussetzung: du musst dem Bot einmal /start geschickt haben.

Funktioniert der Bot, wenn mein Handy aus ist?

Ja. Anders als bei WhatsApp läuft der Telegram-Bot komplett serverbasiert. Dein Handy ist nur Empfänger, nicht Beteiligter.

Was ist mit Verschlüsselung?

Standard-Bot-Chats sind nicht E2E-verschlüsselt. Wer das braucht, müsste eine Lösung mit Telegrams MTProto bauen, das ist nicht trivial. Für die meisten OpenClaw-Setups ist Server-Side-Verschlüsselung der API + EU-Server-Standort ausreichend.

Kann ich den Bot auf Stille stellen?

Ja. In Telegram pro Chat: Notification mute. Auf Bot-Seite: Heartbeat-Frequenz reduzieren oder Briefings auf Werktage 9-18 Uhr begrenzen.

Wie verbinde ich Telegram mit n8n oder Make?

Über den Telegram-Knoten in n8n bzw. Make. Wer beide Welten verbinden will, schaut in den Beitrag OpenClaw vs. n8n vs. Make.

Tipp: Telegram-Bots laufen besonders zuverlässig, wenn dein VPS stabile Anbindung hat. Hostinger bietet KVM-VPS in Frankfurt mit DSGVO-Standort, ab wenigen Euro pro Monat, ideal als 24/7-Heimat für deinen OpenClaw-Bot. Hostinger ansehen →Affiliate-Link — wir erhalten eine Provision, wenn du über diesen Link bestellst. Für dich ändert sich am Preis nichts.

Bonus: 5 fortgeschrittene Use-Cases mit Telegram-Bot

Wer den Standard hinter sich hat und mehr aus dem Setup holen will, hier fünf Ideen aus der Praxis:

1. Sprachnotizen als Knowledge-Base: Voice senden, Agent transkribiert, fasst zusammen, legt in memory/notes/ ab. Ergebnis: dein eigenes Voice-First-Notizsystem.
2. Reise-Briefing: Beim Reisen Foto vom Ticket schicken, Agent extrahiert Datum, Flughafen, Hotel und legt einen Reise-Skill an, der dir morgens vor dem Flug ein Briefing schickt (Wetter, Verkehr, lokale News).
3. Rezept-Helfer: Foto eines Rezepts senden, Agent extrahiert Zutaten, schickt Einkaufsliste an Notion oder Todoist. Bonus: schlägt vor, was du davon schon zu Hause hast (wenn du eine Vorrats-Datei pflegst).
4. Lese-Assistent: Artikel-Link an den Bot schicken, Agent liest, fasst zusammen, schickt Zusammenfassung plus 3 Kernpunkte zurück. Kombiniert mit dem QMD-Skill landet alles im Wissens-Archiv.
5. Kontaktformular-Triage: Eingehende Kontakt-Mails (per Forward an einen festen Telegram-Channel oder per IMAP-Skill) werden automatisch klassifiziert. Wichtige Anfragen pingen dich, Standard-Anfragen bekommen Auto-Drafts.

Diese Setups bauen alle auf den gleichen Bausteinen auf: Allowlist, Voice-Provider, QMD-Skill, ein bisschen AGENTS.md-Logik. Wenn das Grundsetup steht, ist der Aufwand pro neuem Use-Case oft eine Stunde.

Fazit

Telegram ist die schnellste, stabilste und einsteigerfreundlichste Anbindung an OpenClaw. In 10 Minuten Setup hast du einen KI-Assistenten, der dich überall begleitet, mit voller Datenkontrolle, ohne QR-Code-Stress und mit allen erweiterten Funktionen wie Voice, Bilder und Inline-Modus.

Wer OpenClaw zum ersten Mal aufsetzt, sollte mit Telegram beginnen. WhatsApp und andere Kanäle kannst du immer noch dazuschalten. Der Einstieg startet komfortabel mit Modul 1: OpenClaw verstehen und Modul 2: Server einrichten.