OpenClaw mit Telegram verbinden: Dein Assistent im Messenger

Du möchtest deinen eigenen Assistenten vom Handy anschreiben? Telegram ist dafür ein möglicher Kanal. OpenClaw verbindet sich mit einem Bot, den du über Telegrams BotFather anlegst. Dein privates Benutzerkonto und der Bot sind dabei zwei unterschiedliche Identitäten. Beginne ausschließlich mit einem Einzelchat; Gruppen und weitreichende Werkzeugrechte kommen nicht automatisch dazu.

Was du vorher brauchst

Vorausgesetzt sind eine funktionierende OpenClaw-Testinstallation, eine echte Modellantwort und dein eigenes Telegram-Konto. Der Gateway muss während der Nutzung laufen. Der Bot selbst ersetzt keinen Modellanbieter; dessen Nutzung kann weiterhin Kosten verursachen. Beachte außerdem die Datenwege: Nachrichten gehen durch Telegram und gegebenenfalls anschließend an einen Cloudmodell-Anbieter.

Dieser Leitfaden folgt den offiziellen Telegram- und OpenClaw-Unterlagen mit Abgleich am 1. November 2026, OpenClaw-Referenz v2026.10.7. Er ist kein behaupteter neuer End-to-End-Test deiner Umgebung. Wir zeigen keine echten Tokens, Konten oder privaten Chats.

Den richtigen BotFather öffnen

1. Öffne in Telegram den offiziellen Account @BotFather. Prüfe den Namen genau; ähnlich geschriebene Accounts sind kein Ersatz.
2. Sende /newbot und folge den Fragen nach Anzeigename und Benutzername.
3. Speichere den erhaltenen Bot-Token in deinem Passwortmanager. Dieser Token erlaubt technische Zugriffe auf deinen Bot.
4. Notiere getrennt den öffentlichen Benutzernamen. Diesen darfst du teilen; den Token nicht.

Telegram bietet daneben eine offizielle BotFather-Weboberfläche an. Nutze einen der dokumentierten Wege, nicht irgendeinen „Bot-Generator“ mit fremdem Formular. Wenn jemand deinen Token erhalten hat, widerrufe ihn bei BotFather und richte einen neuen ein.

Token lokal hinterlegen, Zugriff eng lassen

Die OpenClaw-Dokumentation unterstützt eine Konfiguration im Telegram-Abschnitt mit botToken oder einer tokenFile. Verwende für echte Werte die vorgesehene lokale Konfiguration beziehungsweise eine geschützte Token-Datei. Übergib den Token nicht als kopierten Beispielbefehl: Befehlszeilen können in Shellverläufen oder Prozessansichten landen.

Das folgende JSON ist nur ein Ausschnitt zur Orientierung. Es enthält absichtlich einen ungültigen Platzhalter. Ersetze nicht deine gesamte vorhandene Konfiguration damit:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "DEIN_BOT_TOKEN_NUR_LOKAL",
      "dmPolicy": "pairing",
      "groupPolicy": "disabled"
    }
  }
}

Die Pairing-Regel verlangt eine Freigabe unbekannter Direktnachrichten. Gruppen bleiben für diesen Einstieg deaktiviert. Wenn deine Version andere Felder meldet, halte an und verwende die passende Referenz. Ein ungültiges Feld ist kein Grund, Zugriffsbeschränkungen zu entfernen.

Kanal prüfen und dein Konto verbinden

openclaw channels status --probe

Prüfe damit, ob der Kanal tatsächlich erreichbar ist. Bei laufendem Gateway kann die dokumentierte Konfigurationsaktualisierung Änderungen übernehmen; nach geänderter Dienstumgebung kann ein Neustart nötig sein. Starte keinen zweiten Gateway neben dem vorhandenen Dienst.

Öffne nun in Telegram deinen eigenen Bot und sende eine harmlose Nachricht. Anschließend prüfst du am Rechner die wartenden Anfragen:

openclaw pairing list telegram
openclaw pairing approve telegram CODE_AUS_DEINER_ANFRAGE

Der zweite Befehl enthält einen Platzhalter. Ersetze ihn nur durch den Code, dessen Anfrage zu deinem eigenen Konto gehört. Bestätige nicht einfach die erste unbekannte Anfrage in der Liste. Pairing verbindet nicht jeden Telegram-Nutzer mit deinem Assistenten, sondern gibt die konkret geprüfte Identität frei.

Den richtigen Erfolg prüfen

Sende nach der Freigabe: „Antworte mit TELEGRAM TEST OK. Führe keine Werkzeuge aus.“ Die Antwort sollte im privaten Botchat erscheinen. Vergleiche den Zeitpunkt mit dem OpenClaw-Kanalstatus. Eine Nachricht, die Telegram als zugestellt markiert, beweist nur die Zustellung an Telegram, nicht eine erfolgreiche Modellantwort.

Long Polling ist laut Dokumentation der Standard. Dabei holt OpenClaw Nachrichten über ausgehende Verbindungen ab. Für diesen Einstieg musst du keinen öffentlichen Webhook und keine offene Gateway-Portweiterleitung einrichten. Ein fremder Tutorialschritt zum Freigeben des Dashboards ist dafür nicht erforderlich.

Wenn der Bot schweigt

• „Unauthorized“ oder ungültiger Token: Token lokal prüfen und bei Bedarf beim echten BotFather ersetzen.
• Pairing-Anfrage, aber keine Antwort: die richtige Identität freigeben und erneut eine unkritische Nachricht senden.
• Konflikt beim Nachrichtenabruf: prüfen, ob ein zweites Programm denselben Bot betreibt.
• Telegram funktioniert, Modell scheitert: Anbieterzugang und Kontingent getrennt vom Kanal untersuchen.

Nutze beim Support keine ungefilterten Konfigurationsdateien oder Protokolle. Schon die Umgebung einer Fehlermeldung kann Token oder private Nachrichten enthalten.

Gruppen erst als eigener Ausbau

Ein funktionierender Einzelchat ist kein sicherer Gruppenassistent. Dafür müssen Gruppen-ID, erlaubte Absender, Erwähnungsregeln und Werkzeugrechte ausdrücklich geprüft werden. Gib einem Bot nicht pauschal Administratorrechte, nur um eine fehlende Antwort zu beheben. Beim Abbruch deaktiviere den Kanal, widerrufe ungenutzte Bot-Tokens und kontrolliere, dass keine zweite Instanz weiterläuft.

Eine Freigabe ist kein allgemeiner Werkzeugauftrag

Der gekoppelte Telegram-Nutzer darf nach den eingerichteten Regeln mit dem Assistenten sprechen. Daraus folgt nicht, dass jede Nachricht automatisch eine Serveränderung oder einen Versand an andere Personen rechtfertigt. Beginne mit Antworten ohne Außenwirkung. Wenn du später Werkzeuge ergänzst, teste an unkritischen Daten jeweils genau eine Fähigkeit und kontrolliere das tatsächliche Ergebnis.

Behalte außerdem den Geräteverlust im Blick: Wer dein entsperrtes Telegram-Konto verwendet, kann möglicherweise unter deiner Identität schreiben. Schütze deshalb Telegram selbst und die angemeldeten Geräte. Die Absicherung endet nicht beim Bot-Token auf dem Server.

Unterstützung beim eigenen Aufbau

Du möchtest den Zugang und die Zuständigkeiten für dein eigenes Projekt sauber planen? Über VollmerIT kannst du eine individuelle Anfrage stellen. Umfang und Kosten werden vorab vereinbart.

Einrichtung und Beratung bei VollmerIT anfragen

Redaktions- und Quellenstand: 1. November 2026. Dokumentationsgestützter Ratgeber; Beispiele sind Lernmaterial, keine behaupteten eigenen Anbieter- oder Hardwaretests.