Comment connecter OpenClaw à Telegram

En bref. Créez un bot avec @BotFather dans Telegram (/newbot) et copiez son token. Donnez le token à OpenClaw, puis n’autorisez que votre propre ID utilisateur Telegram numérique à lui écrire. Sur votre propre machine, c’est openclaw channels add --channel telegram --token <token> plus dmPolicy: "allowlist" avec votre ID dans allowFrom. Sur PlayNHost, vous collez le token et votre ID sur la page Agent, puis vous redémarrez.

Vérifié le 6 novembre 2026, exact pour OpenClaw 2026.11.1.

Ce guide s’appuie sur la documentation Telegram d’OpenClaw et sur le panel PlayNHost tel qu’il fonctionne aujourd’hui. Telegram est intégré à OpenClaw : il n’y a aucun plugin à installer.

Étape 1 : créer le bot et copier son token

1. Dans Telegram, ouvrez une conversation avec @BotFather. Vérifiez que le nom est exactement @BotFather.
2. Envoyez /newbot, choisissez un nom d’affichage, puis un nom d’utilisateur qui se termine par bot.
3. BotFather répond avec le token, qui ressemble à 123456789:AAH.... Gardez-le privé : quiconque l’a peut contrôler votre bot.

BotFather propose aussi une application web (t.me/BotFather?startapp) qui fait la même chose avec des boutons.

Utilisez un bot sur lequel rien d’autre ne tourne. Si un ancien OpenClaw sur votre portable, ou un autre programme, utilise encore le même token, arrêtez-le d’abord ou créez un nouveau bot.

Étape 2 : trouver votre ID utilisateur Telegram

La liste autorisée d’OpenClaw attend votre ID utilisateur numérique, pas votre @nom d’utilisateur, votre numéro de téléphone ni l’ID du bot. Voici les moyens que cite la doc d’OpenClaw :

• Depuis le bot lui-même (sans tiers). Tant que le bot est en mode pairing, envoyez-lui un message quelconque. Sa réponse de pairing contient « Your Telegram user id ». Sur PlayNHost, c’est la voie que nous suggérons, voir plus bas.
• Depuis le journal d’OpenClaw. Lancez openclaw logs --follow, écrivez au bot et lisez senderUserId dans l’entrée telegram pairing request.
• Avec l’API de Telegram. Écrivez au bot, puis ouvrez https://api.telegram.org/bot<bot_token>/getUpdates et lisez message.from.id.
• Un bot tiers comme @userinfobot ou @getidsbot. La doc d’OpenClaw juge cela moins privé.

Étape 3 sur PlayNHost : collez le token et votre ID

Il vous faut une clé de fournisseur d’IA sur la même page. Sans elle, Démarrer s’arrête avec « Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token. » (la Console l’affiche en anglais : votre agent n’est pas encore configuré, il lui faut une clé API et un token de bot).

1. Ouvrez votre serveur sur panel.playnhost.com, puis l’onglet Agent.
2. Sous Fournisseur d’IA, définissez une clé si ce n’est pas déjà fait (voir quelle clé de fournisseur d’IA utiliser).
3. Sous Applis de chat, appuyez sur Définir pour Token du bot Telegram, collez le token de BotFather et appuyez sur Enregistrer. Le panel vérifie sa forme : un mauvais collage affiche « That is not a valid telegram bot token. » (ce n’est pas un token de bot Telegram valide). Une fois enregistré, la ligne n’affiche que les quatre derniers caractères, et le token n’est plus jamais affiché.
4. Vous ne connaissez pas encore votre ID ? Laissez ID utilisateur Telegram vide et appuyez sur Démarrer. Quand l’agent est en marche, la Console affiche :

   [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.

   Cela signifie : votre agent tourne, mais personne ne peut encore lui écrire. Envoyez un message à votre bot dans Telegram. Il répond une fois avec un code de pairing et votre ID utilisateur Telegram (OpenClaw envoie un code environ une fois par heure et par personne, et ignore les messages entre-temps). Copiez l’ID et ignorez le code : sur PlayNHost, il n’y a rien à approuver. Cette étape ne laisse entrer personne.
5. Sous Qui peut lui écrire, saisissez votre ID dans ID utilisateur Telegram et appuyez sur Enregistrer. Plusieurs ID se mettent sur une seule ligne, séparés par des virgules.
6. La page indique « Les changements s’appliquent au prochain démarrage de votre agent. » Appuyez sur Redémarrer maintenant. La Console confirme alors :

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

7. Écrivez à votre bot. Votre agent répond. Les messages de tout autre compte Telegram sont ignorés.

Ce que PlayNHost règle pour vous

• Avec des ID dans le volet Agent, les DM Telegram utilisent dmPolicy: "allowlist" avec exactement ces ID, ce que recommande la doc d’OpenClaw pour un bot à un seul propriétaire. Sans ID, ils utilisent pairing : les inconnus reçoivent un code et sont ignorés, et personne ne peut les approuver sans la ligne de commande ou le tableau de bord d’OpenClaw, qu’un serveur PlayNHost ne propose ni l’un ni l’autre.
• Les ID que vous listez deviennent aussi les propriétaires des commandes d’OpenClaw (commands.ownerAllowFrom), de sorte que les commandes réservées au propriétaire fonctionnent pour vous dès le premier message.
• Le token parvient à OpenClaw sous le nom TELEGRAM_BOT_TOKEN dans son environnement. Un token écrit dans le propre fichier de réglages d’OpenClaw l’emporterait sur celui-là : le démarrage le retire donc du fichier, et c’est le token du volet Agent qui sert.
• Les groupes restent fermés : OpenClaw n’en admet aucun tant qu’il n’est pas ajouté à ses réglages, et un réglage qui laisserait tout le monde parler à l’agent est remis sur vos ID au démarrage suivant.

Étape 3 sur votre propre machine

1. Ajoutez le token :

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

   ou définissez TELEGRAM_BOT_TOKEN dans l’environnement du Gateway. Un token dans le fichier de configuration l’emporte sur la variable d’environnement.
2. N’autorisez que vous dans ~/.openclaw/openclaw.json :

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

   La partie commands fait de vous le propriétaire pour les commandes réservées au propriétaire : OpenClaw ne le fait pas pour une liste autorisée écrite à la main. Une allowlist avec un allowFrom vide bloque tous les DM et est rejetée par la vérification de configuration d’OpenClaw.
3. Ou gardez le mode pairing par défaut et approuvez-vous après votre premier message :

   openclaw pairing list telegram
   openclaw pairing approve telegram <CODE>

   Les codes expirent au bout d’une heure. Le premier pairing approuvé fait aussi de vous le propriétaire des commandes.
4. Vérifiez le canal avec openclaw channels status --probe.

Quand il ne répond pas

Vous voulez aussi Discord ? Voyez connecter OpenClaw à Discord. Pas encore installé ? Créez un serveur OpenClaw.

PlayNHost n’est pas affilié à l’OpenClaw Foundation. OpenClaw est un logiciel open source sous licence MIT.