OpenClaw mit Telegram verbinden

Kurz gesagt. Erstelle in Telegram mit @BotFather einen Bot (/newbot) und kopiere seinen Token. Gib den Token an OpenClaw und erlaube dann nur deiner eigenen numerischen Telegram-Nutzer-ID, ihm zu schreiben. Auf deinem eigenen Rechner ist das openclaw channels add --channel telegram --token <token> plus dmPolicy: "allowlist" mit deiner ID in allowFrom. Auf PlayNHost fügst du Token und ID auf der Seite Agent ein und startest neu.

Geprüft am 6. November 2026, gültig für OpenClaw 2026.11.1.

Diese Anleitung stützt sich auf die Telegram-Dokumentation von OpenClaw und das PlayNHost-Panel, so wie es heute funktioniert. Telegram ist in OpenClaw eingebaut: Es gibt kein Plugin zu installieren.

Schritt 1: Bot erstellen und Token kopieren

1. Öffne in Telegram einen Chat mit @BotFather. Achte darauf, dass der Name genau @BotFather lautet.
2. Sende /newbot, wähle einen Anzeigenamen und dann einen Benutzernamen, der auf bot endet.
3. BotFather antwortet mit dem Token, der etwa so aussieht: 123456789:AAH.... Halte ihn geheim: Wer ihn hat, kann deinen Bot steuern.

BotFather hat außerdem eine Web-App (t.me/BotFather?startapp), die dasselbe mit Schaltflächen erledigt.

Nimm einen Bot, auf dem sonst nichts läuft. Wenn ein älteres OpenClaw auf deinem Laptop oder ein anderes Programm denselben Token noch nutzt, stoppe es zuerst oder erstelle einen neuen Bot.

Schritt 2: Deine Telegram-Nutzer-ID finden

Die Allowlist von OpenClaw verlangt deine numerische Nutzer-ID, nicht deinen @Benutzernamen, deine Telefonnummer oder die ID des Bots. Diese Wege nennt die Doku von OpenClaw:

• Vom Bot selbst (ohne Dritte). Solange der Bot im Modus pairing ist, sende ihm irgendeine Nachricht. Seine Pairing-Antwort enthält „Your Telegram user id“. Auf PlayNHost empfehlen wir diesen Weg, siehe unten.
• Aus dem Log von OpenClaw. Führe openclaw logs --follow aus, schreibe dem Bot und lies senderUserId im Eintrag telegram pairing request.
• Über die Telegram-API. Schreibe dem Bot und öffne dann https://api.telegram.org/bot<bot_token>/getUpdates. Lies dort message.from.id.
• Ein Drittanbieter-Bot wie @userinfobot oder @getidsbot. Die Doku von OpenClaw nennt das weniger privat.

Schritt 3 auf PlayNHost: Token und ID einfügen

Du brauchst auf derselben Seite einen KI-Anbieter-Schlüssel. Ohne ihn bricht Start mit „Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token.“ ab (die Console meldet das auf Englisch: Dein Agent ist noch nicht eingerichtet, er braucht einen API-Schlüssel und einen Bot-Token).

1. Öffne deinen Server unter panel.playnhost.com, dann den Tab Agent.
2. Setze unter KI-Anbieter einen Schlüssel, falls du das noch nicht getan hast (siehe welchen KI-Schlüssel du nutzt).
3. Drücke unter Chat-Apps bei Telegram-Bot-Token auf Setzen, füge den Token von BotFather ein und drücke Speichern. Das Panel prüft seine Form: Bei einer falschen Eingabe erscheint „That is not a valid telegram bot token.“ (also: kein gültiger Telegram-Bot-Token). Nach dem Speichern zeigt die Zeile nur noch die letzten vier Zeichen, und der Token wird nie wieder angezeigt.
4. Du kennst deine ID noch nicht? Lass Telegram-Nutzer-IDs leer und drücke Starten. Sobald der Agent oben ist, gibt die Console aus:

   [PlayNHost] Your agent is running
   [PlayNHost] Telegram: nobody can message your agent yet. Send your bot any message: it answers with your Telegram user ID. Copy that ID, put it on the Agent page, then restart. Ignore the pairing code in its reply.

   Das heißt: Dein Agent läuft, aber noch kann ihm niemand schreiben. Sende deinem Bot eine Nachricht in Telegram. Er antwortet einmal mit einem Pairing-Code und deiner Telegram-Nutzer-ID (OpenClaw sendet etwa einmal pro Stunde und Person einen Code und ignoriert die Nachrichten dazwischen). Kopiere die ID und ignoriere den Code: Auf PlayNHost muss nichts freigegeben werden. Dieser Schritt lässt niemanden hinein.
5. Trage unter Wer ihm schreiben darf deine ID bei Telegram-Nutzer-IDs ein und drücke Speichern. Mehrere IDs kommen in eine Zeile, durch Kommas getrennt.
6. Die Seite sagt „Änderungen gelten ab dem nächsten Start deines Agents.“ Drücke Jetzt neu starten. Die Console bestätigt dann:

   [PlayNHost] Telegram: only user 123456789 can message your agent.

7. Schreib deinem Bot. Dein Agent antwortet. Nachrichten von jedem anderen Telegram-Konto werden ignoriert.

Was PlayNHost für dich einstellt

• Sind IDs im Bereich Agent eingetragen, nutzen Telegram-DMs dmPolicy: "allowlist" mit genau diesen IDs. Das empfiehlt die Doku von OpenClaw für einen Bot mit einem Besitzer. Ohne ID gilt pairing: Fremde bekommen einen Code und werden ignoriert, und niemand kann sie freigeben, ohne die Kommandozeile oder das Dashboard von OpenClaw zu nutzen, und beides bietet ein PlayNHost-Server nicht.
• Die IDs, die du einträgst, werden auch zu den Besitzer für Befehle bei OpenClaw (commands.ownerAllowFrom), sodass Owner-Befehle ab der ersten Nachricht für dich funktionieren.
• Der Token erreicht OpenClaw als TELEGRAM_BOT_TOKEN in seiner Umgebung. Ein Token in der eigenen Einstellungsdatei von OpenClaw hätte Vorrang davor, deshalb entfernt der Start ihn aus der Datei: Es gilt der Token aus dem Bereich Agent.
• Gruppen bleiben geschlossen: OpenClaw lässt keine Gruppe zu, bis eine in seinen Einstellungen hinzugefügt wird, und eine Einstellung, die jedem erlaubt, mit dem Agent zu sprechen, wird beim nächsten Start auf deine IDs zurückgesetzt.

Schritt 3 auf deinem eigenen Rechner

1. Füge den Token hinzu:

   openclaw channels add --channel telegram --token <bot-token>

   oder setze TELEGRAM_BOT_TOKEN in der Umgebung des Gateways. Ein Token in der Konfigurationsdatei hat Vorrang vor der Umgebungsvariable.
2. Erlaube nur dir selbst Zugriff in ~/.openclaw/openclaw.json:

   {
     channels: {
       telegram: {
         enabled: true,
         dmPolicy: "allowlist",
         allowFrom: ["123456789"],
       },
     },
     commands: {
       ownerAllowFrom: ["telegram:123456789"],
     },
   }

   Der Teil commands macht dich zum Besitzer für Owner-Befehle: Bei einer von Hand geschriebenen Allowlist tut OpenClaw das nicht. Eine allowlist mit leerem allowFrom blockiert jede DM und wird von der Konfigurationsprüfung von OpenClaw abgelehnt.
3. Oder behalte den Standardmodus pairing und gib dich nach deiner ersten Nachricht selbst frei:

   openclaw pairing list telegram
   openclaw pairing approve telegram <CODE>

   Codes laufen nach einer Stunde ab. Das erste freigegebene Pairing macht dich auch zum Besitzer für Befehle.
4. Prüfe den Kanal mit openclaw channels status --probe.

Wenn er nicht antwortet

Willst du auch Discord? Siehe OpenClaw mit Discord verbinden. Noch nicht eingerichtet? Erstelle einen OpenClaw-Server.

PlayNHost ist nicht mit der OpenClaw Foundation verbunden. OpenClaw ist Open-Source-Software unter der MIT-Lizenz.