OpenClaw sur Telegram

Telegram est le canal que la documentation d’OpenClaw dit le plus rapide à configurer : un jeton de bot obtenu auprès de BotFather et rien d’autre. C’est aussi le canal qui compte le plus de fils sur les groupes muets, parce que le mode privé de Telegram et le filtrage par mention d’OpenClaw décident tous deux de ce que le bot voit. Voici la configuration, le modèle d’accès, et les quatre raisons pour lesquelles un bot Telegram cesse de répondre.

Configuration en quatre étapes

• Créez le bot dans BotFather, en discussion ou dans son application web, et conservez le jeton.
• Donnez le jeton à OpenClaw avec une seule commande d’ajout de canal, ou écrivez-le à la main dans la configuration. Il n’y a pas d’étape de connexion pour Telegram.
• Sondez l’état du canal. Une passerelle en marche applique le nouveau canal par rechargement à chaud ; une passerelle arrêtée doit être démarrée.
• Envoyez n’importe quel message au bot, puis approuvez la demande d’appairage que ce message a créée. Les codes expirent au bout d’une heure.

Les groupes ajoutent deux identifiants : votre identifiant utilisateur numérique pour les listes d’autorisation, et l’identifiant du groupe comme clé de la section des groupes, où les identifiants de supergroupes commencent par moins cent. Par défaut, un groupe exige une mention, et le mode privé de Telegram limite ce que le bot reçoit tant que vous ne l’avez pas désactivé dans BotFather ou fait du bot un administrateur, puis retiré et rajouté le bot pour que Telegram applique le changement.

Qui peut lui parler

Les messages directs suivent une politique : appairage par défaut, liste d’autorisation d’identifiants numériques, ouverture avec un joker explicite pour les bots volontairement publics, ou désactivation. L’approbation d’appairage n’accorde que l’accès en messages directs ; elle n’autorise pas un expéditeur partout, et l’autorisation des commandes s’applique même dans un groupe ouvert. Pour un bot à propriétaire unique, la documentation recommande la liste d’autorisation avec votre propre identifiant numérique plutôt que d’anciens appairages, et une politique d’outils par discussion peut refuser les outils d’écriture et de modification dans tous les messages directs sauf les vôtres.

L’approbation d’un appairage en messages directs ne signifie pas « cet expéditeur est autorisé partout ». L’appairage n’accorde que l’accès en messages directs.

Quatre raisons du silence

• Le mode privé : même sans filtrage par mention, le bot ne voit rien tant que le mode privé n’est pas désactivé dans BotFather et le bot retiré puis rajouté.
• Le groupe n’est pas listé : dès qu’une section de groupes existe, un groupe absent est écarté avant le routage, et les journaux indiquent la raison.
• Le jeton est rejeté au démarrage : un 401 sur l’appel d’identité signifie que le jeton est faux. Recopiez-le ou régénérez-le.
• Le sondage cale : les hôtes qui préfèrent IPv6 avec une sortie IPv6 cassée, les proxys et la sélection d’adresse de Node produisent des échecs intermittents. La documentation fournit un réglage de proxy et un commutateur IPv4 seul, et la passerelle relance le sondage après deux minutes sans sondage abouti.

L’échelle générale pour un agent muet, tous canaux confondus, se trouve dans OpenClaw ne répond pas.

Sur Diali

Le tableau de bord Diali guide l’étape BotFather avec des captures d’écran, garde le jeton dans le coffre, et la passerelle, son rechargement à chaud et son sondage sont pris en charge. L’appairage, les listes d’autorisation et le filtrage par mention restent à vous, parce qu’ils décident qui peut commander votre assistant. Telegram sur Diali est la page du canal, et OpenClaw hébergé sur Diali est l’assistant qu’il relie.

• Jeton, configuration, sonde, approbation.
• L’appairage n’ouvre que les messages directs ; les groupes exigent des identifiants et, en général, une mention.
• Le mode privé et le sondage expliquent la plupart des silences.