Messages riches et approbations Telegram dans OpenClaw

Le texte n’est que le début de ce qu’un bot Telegram peut envoyer : des blocs formatés, un clavier sous un message, un lanceur de Mini App, une réaction sur le message de quelqu’un d’autre, une demande d’approbation à deux boutons. OpenClaw expose chacun d’eux par un petit ensemble de clés de configuration et d’actions de message, la plupart désactivées tant que vous ne les activez pas. Voici le contrat de formatage, les portées des boutons, les actions et leurs barrières, et comment une approbation d’exécution atteint un approbateur dans Telegram.

Formatage

• Le texte sortant utilise par défaut le HTML standard de Telegram, lisible sur les clients actuels, avec gras, italique, liens, code, spoilers et citations, et le code délimité garde son contenu et ses espaces littéraux, y compris des exemples de délimiteurs dans le bloc ; les blocs propres à l’API Bot 10.3, tableaux natifs, détails, médias riches et formules, ne sont pas utilisés sans activation.
• Avec l’indicateur de messages riches activé, l’agent est informé que les messages riches sont disponibles pour ce bot ou ce compte avec le contrat de rédaction Markdown et îlots HTML pris en charge, le Markdown est rendu par la représentation intermédiaire Markdown d’OpenClaw en blocs riches typés, titres, tableaux, détails, listes à cocher, médias riches, formules, cartes et collages, tandis que les légendes de médias restent des légendes HTML plafonnées à 1024 caractères ; le texte riche ordinaire conserve les espaces et sauts de ligne analysés, les entités se décodent une fois, les balises échappées restent du texte visible, le HTML non pris en charge reste visible sans supprimer le Markdown qu’il contient, le texte riche long se découpe automatiquement selon les limites de Telegram, et les tableaux au-delà de 20 colonnes retombent en bloc de code.
• L’indicateur est désactivé par défaut par compatibilité, parce que certains clients actuels Desktop, Web, Android et tiers affichent les messages riches acceptés comme non pris en charge ; gardez-le désactivé sauf si chaque client utilisé avec le bot peut les afficher, et la commande d’état montre si la session courante a les messages riches activés ou non.
• Les aperçus de liens sont activés par défaut, et la clé d’aperçu de liens réglée sur faux désactive la détection automatique d’entités pour le texte riche ; tenir le texte du modèle à l’écart des sigils du Markdown riche de Telegram est aussi ce qui évite qu’une fourchette de prix comme 400 à 600 K dollars soit lue comme une formule.

Les boutons de Mini App ne fonctionnent que dans les discussions privées entre un utilisateur et le bot.

Boutons intégrés

La capacité de boutons intégrés a cinq portées, off, dm, group, all et allowlist, allowlist étant la valeur par défaut, réglée au niveau du canal et surchargée par compte ; l’ancienne forme en tableau correspond à all, un compte avec un tableau de capacités vide hérite des capacités du canal, et un off explicite désactive les boutons. L’outil de question à l’utilisateur emploie ces contrôles natifs pour une question à choix unique, une ligne par choix, avec un choix Autre qui ouvre la saisie de réponse de Telegram. Une action de message porte une présentation avec un bloc de boutons, chaque bouton ayant une étiquette, une action et un style facultatif comme succès ou danger ; une action de rappel renvoie sa valeur, et une action de web-app ouvre une URL de Mini App, ce qui ne fonctionne que dans les discussions privées entre un utilisateur et le bot. Les valeurs de rappel non réclamées par un gestionnaire interactif d’extension enregistré sont transmises à l’agent en texte préfixé par callback data. Avec l’ingestion durable, l’accusé du rappel est envoyé dès que la mise à jour est stockée, sans attendre les gestionnaires précédents de la voie de cette discussion, donc Telegram efface tôt son indicateur de chargement tandis que l’action du bouton suit toujours l’autorisation normale et le traitement ordonné.

Actions et approbations

• Les actions sont l’envoi de message avec une cible, un contenu et facultativement une URL de média, un identifiant de réponse et un identifiant de fil, la réaction avec une discussion, un message et un emoji, la liste d’emojis avec une discussion et une limite facultatives, la suppression de message, la modification de message avec un contenu ou une légende et des boutons intégrés facultatifs, une modification limitée aux boutons mettant à jour la mise en forme de réponse, et la création de sujet de forum avec un nom et une couleur d’icône ou un emoji personnalisé facultatifs, plus les alias send, react, delete, edit, sticker, sticker-search et topic-create ; les barrières d’envoi, de suppression, de réactions et de stickers sont désactivées par défaut, la barrière de réactions couvre à la fois la réaction et la liste d’emojis, la modification et les actions de sujet de forum sont activées sans interrupteur dédié, et les envois à l’exécution utilisent l’instantané de configuration et de secrets du démarrage ou du rechargement plutôt que de résoudre à nouveau les références de secrets à chaque envoi.
• La liste d’emojis inspecte les réactions autorisées dans la discussion et le compte de confiance courants, les agents ne peuvent pas inspecter une autre discussion tandis que les opérateurs directs peuvent passer un autre identifiant, la limite vaut 100 par défaut et ne peut pas le dépasser, une discussion sans restriction renvoie les réactions standard avec une note disant qu’elles sont toutes autorisées, une réaction rejetée renvoie un court échantillon de réactions standard et d’identifiants d’emojis personnalisés autorisés sauf si la recherche elle-même a échoué, et vous passez directement un emoji Unicode ou un identifiant numérique d’emoji personnalisé à la réaction.
• Les approbations d’exécution fonctionnent dans les messages privés des approbateurs et peuvent aussi publier les demandes dans la discussion ou le sujet d’origine, les approbateurs doivent être des identifiants numériques, la clé d’activation en auto les active dès qu’un approbateur est résoluble, la liste des approbateurs retombe sur les identifiants numériques des propriétaires de la liste des propriétaires, la cible est dm par défaut avec channel et both comme alternatives, des filtres d’agent et de session les restreignent, les listes d’autorisation qui décident qui peut parler au bot ne font de personne un approbateur même si le premier appairage approuvé amorce la liste des propriétaires, la livraison en canal montre le texte de la commande donc channel ou both n’ont leur place que dans des groupes de confiance, une demande qui atterrit dans un sujet de forum garde ce sujet pour la suite, les approbations expirent après 30 minutes par défaut, les boutons d’approbation intégrés exigent que la capacité de boutons autorise la surface visée, et les identifiants d’approbation préfixés par plugin se résolvent par les approbations d’extension tandis que les autres essaient d’abord les approbations d’exécution.

OpenClaw sur Telegram est le billet du canal que ces surfaces prolongent, et Le comportement des messages Telegram dans OpenClaw le modèle de livraison en dessous.

Des boutons d’un canal à l’autre

Le bloc de boutons, la valeur de rappel et la demande d’approbation gardent la même forme sur chaque canal doté de composants natifs, ce qui permet à un agent de poser une question par oui ou non sans savoir où elle sera répondue. Composants et approbations Discord dans OpenClaw montre le côté Discord de ce contrat, et Les réactions dans OpenClaw la sémantique des réactions que la réaction et la liste d’emojis mettent en œuvre.

Sur Diali

Telegram fait partie des canaux que Diali connecte depuis le tableau de bord, et la configuration d’exécution générée est remplacée à chaque version, donc les clés de formatage et de boutons décrites ici disent ce qu’un bot hébergé peut faire plutôt que des réglages à modifier à la main. Telegram sur Diali est le canal sur Diali et La sécurité chez Diali la frontière qui s’applique à chaque action qu’un bot peut entreprendre.

• HTML par défaut ; des blocs riches seulement si chaque client sait les afficher.
• Les boutons suivent une portée ; les Mini Apps s’ouvrent en privé seulement.
• Envois, suppressions, réactions et stickers restent désactivés tant qu’ils ne sont pas ouverts.