Configurer Telegram dans OpenClaw

Un bot Telegram est le canal le plus rapide à mettre en place, parce que toute la configuration tient en un jeton de BotFather et une commande qui le stocke. Voici la configuration rapide étape par étape, les règles de priorité des jetons, les réglages qui vivent côté Telegram plutôt que dans la configuration, et le choix de transport entre le sondage long et un webhook.

Configuration rapide

• Les deux parcours de BotFather se terminent par un jeton que vous collez dans OpenClaw : le parcours de discussion, où vous parlez au compte BotFather, vérifiez que l’identifiant est exact, lancez la commande de nouveau bot et enregistrez le jeton, ou le parcours web dans l’application web de BotFather, qui tourne dans chaque client Telegram et vous laisse créer le bot dans une interface et copier son jeton.
• La façon la plus rapide de le configurer est la commande d’ajout de canal avec le canal Telegram et le jeton, qui écrit le jeton dans la configuration pour vous ; éditer à la main signifie un bloc Telegram avec le canal activé, le jeton de bot, la politique d’appairage pour les messages privés et une entrée de groupe joker qui exige une mention, et la variable d’environnement du jeton de bot n’est un repli que pour le compte par défaut, les comptes nommés devant utiliser la clé de jeton ou un fichier de jeton.
• Avec le rechargement à chaud par défaut, la passerelle en cours applique la nouvelle configuration du canal, et la sonde d’état des canaux vérifie que Telegram est prêt ; si la passerelle est hors ligne, vous la démarrez comme service géré ou dans le terminal, et un environnement de service modifié exige un redémarrage pour être chargé.
• Envoyer n’importe quel message au bot crée la demande d’appairage que la commande de liste montre et que la commande d’approbation accepte, avec des codes qui expirent après une heure ; ajouter le bot à un groupe exige ensuite votre identifiant numérique pour les listes d’autorisation et l’identifiant de discussion du groupe comme clé sous la carte des groupes, lu dans les journaux, par un bot d’identifiants transférés ou par les mises à jour de l’API Bot, confirmé par la commande whoami une fois le groupe autorisé, et les identifiants négatifs de supergroupe vont sous les groupes, jamais dans la liste des expéditeurs de groupe.

Telegram n’utilise pas openclaw channels login telegram.

Les jetons et le côté Telegram

La résolution des jetons dépend du compte : un fichier de jeton l’emporte sur la clé de jeton, la clé de jeton l’emporte sur l’environnement, la configuration gagne toujours sur la variable d’environnement, qui ne se résout que pour le compte par défaut, et après un démarrage réussi OpenClaw met en cache l’identité du bot jusqu’à 24 heures pour que les redémarrages évitent un appel getMe supplémentaire, un jeton changé ou retiré vidant ce cache. Côté Telegram, les bots sont en mode privé par défaut, ce qui limite les messages de groupe qu’ils reçoivent ; pour voir tous les messages de groupe, vous désactivez le mode privé avec la commande de réglage du mode privé ou vous faites du bot un administrateur du groupe, et après avoir basculé le mode privé vous retirez et réajoutez le bot dans chaque groupe pour que Telegram applique le changement. Le statut d’administrateur se contrôle dans les réglages du groupe, et les bots administrateurs reçoivent tous les messages du groupe, ce qui convient à un comportement de groupe permanent. Les bascules utiles de BotFather sont le réglage d’ajout aux groupes qui autorise ou refuse les ajouts et le réglage du mode privé pour la visibilité des groupes, tous deux aussi disponibles dans l’application web de BotFather.

Sondage long ou webhook

• Le sondage long est la valeur par défaut ; le mode webhook exige une URL de webhook et un secret de webhook, avec un chemin facultatif qui vaut par défaut la route telegram-webhook, un hôte qui vaut par défaut la boucle locale, un port qui vaut par défaut 8787, et un chemin de certificat pour un PEM auto-signé dans les installations par adresse directe ou sans domaine ; l’écouteur réserve la route de santé aux vérifications de santé, donc le chemin de webhook doit utiliser une autre route, et une installation existante sur cette route doit changer, mettre à jour l’URL et la correspondance du proxy inverse, et vérifier le changement d’écouteur avec la sonde d’état.
• En mode de sondage long, OpenClaw enregistre sa position de reprise après qu’une mise à jour est validée dans la file d’ingestion durable, si bien qu’un gestionnaire échoué reste réessayable depuis cette file ; l’écouteur local se lie à la boucle locale sur le port 8787 par défaut, et une entrée publique signifie un proxy inverse devant lui ou un hôte joker réglé volontairement.
• Le mode webhook valide les gardes de requête, le jeton secret Telegram et le corps JSON, valide la mise à jour dans la file durable avant de renvoyer un 200 vide, et marque une adoption durable réussie par un en-tête de livraison acceptée que les réponses de santé, de routage, d’authentification, de validation et d’erreur de stockage omettent, pour qu’un proxy inverse puisse l’exiger plutôt que de déduire l’acceptation du temps de réponse ; après l’écriture durable, les mises à jour sont réclamées et traitées par le drain d’ingestion central avec des voies par discussion et par sujet, et les tours d’agent lents ne retiennent jamais l’accusé de livraison de Telegram.

OpenClaw sur Telegram est le billet du canal auquel cette configuration appartient, et Le contrôle d’accès Telegram d’OpenClaw ce qu’il faut décider ensuite sur qui peut atteindre le bot.

Là où les configurations échouent

Presque toute configuration Telegram ratée tient à l’une de trois choses : un jeton collé pour un compte nommé par la variable d’environnement qui ne sert que le compte par défaut, un identifiant de groupe mis dans la liste des expéditeurs au lieu de la carte des groupes, ou le mode privé laissé activé avec la mention obligatoire désactivée. Dépanner Telegram dans OpenClaw parcourt ces symptômes dans l’ordre, et Connecter votre premier canal en cinq minutes est le parcours de cinq minutes pour un premier canal.

Sur Diali

Sur Diali, le canal Telegram se connecte depuis le tableau de bord et la configuration d’exécution en est générée puis remplacée à chaque version, donc les étapes BotFather du début de ce billet sont la partie qui reste de votre côté. Telegram sur Diali décrit le canal sur Diali et La sécurité chez Diali la frontière que partage chaque canal connecté.

• Un jeton de BotFather ; la ligne de commande l’écrit pour vous.
• Les codes d’appairage expirent après une heure ; les identifiants de groupe vont sous les groupes.
• Sondage long par défaut ; les webhooks exigent un secret et une route libre.