Débloquer la puissance de Telegram avec OpenClaw Thread Mode

4. Ajouter le bot aux groupes et aux sujets

Pour permettre à ton assistant de participer à des discussions de groupe ou à des sujets de forum, ajoute-le aux groupes Telegram souhaités, puis mets à jour les paramètres de l'assistant. canaux.telegram.groupes configuration. Par exemple :

"canaux" : {
  "télégramme" : {
    "groupes" : {
      "-100123456789" : { "requireMention" : true },
      "*" : { "requireMention" : false }
    },
    "groupPolicy" : "allowlist"
  }
}

Ici, le * sert de fourre-tout à tous les groupes ; requireMention : true garantit que l'assistant n'enverra pas de spams sur le canal. Tu peux également définir politique de groupe à ouvert pour permettre au robot de rejoindre automatiquement tout groupe qui l'invite, ou handicapé pour bloquer complètement l'utilisation des groupes. Après avoir configuré les groupes, redémarre la passerelle et ajoute à nouveau le bot à chaque groupe si tu as modifié les paramètres de confidentialité.

Comprendre le mode thread

Introduction du télégramme thèmes du forum en 2022, ce qui permet aux grands groupes de diviser les conversations en plusieurs fils de discussion. OpenClaw tire parti de cette fonctionnalité en ajoutant :topic: à ses clés de session internes. Cela signifie que chaque sujet a son propre contexte de conversation ; les messages envoyés dans un fil de discussion ne sont pas répercutés dans un autre. Deux comportements importants découlent de cette conception :

1. Isolation du sujet : Lorsque l'assistant reçoit un message avec un message_thread_id, il utilise une clé de session comme télégramme::topic:. Les réponses sont renvoyées au même fil de discussion. C'est ainsi que l'agent maintient le contexte dans les longues discussions à plusieurs branches.
2. Sujet général ou sujet spécifique : Telegram considère le fil de discussion 1 comme le sujet “général” par défaut. Lorsque tu envoies des messages à la discussion 1, tu dois omettre l'élément message_thread_id dans l'appel API, sinon Telegram le rejette. OpenClaw gère cela automatiquement lors de l'envoi de réponses.

Le mode fil n'est pas limité aux supergroupes de forums. Dans les discussions privées (DM), Telegram attache parfois un message_thread_id aux réponses aux messages plus anciens. OpenClaw préserve cet identifiant et utilise des clés de session sensibles aux threads, de sorte que l'historique de tes conversations reste organisé, même dans les DM.

Configuration du mode de réponse

Par défaut, OpenClaw définit canaux.telegram.replyToMode à éteint, qui désactive le filtrage implicite des réponses. Si tu préfères que l'assistant réponde directement au message déclencheur, définis l'option replyToMode à premier fido tous. Tu peux également inclure des balises explicites telles que [[reply_to_current]] fido [[reply_to:]] dans la réponse de ton agent. Ces balises indiquent à la passerelle d'acheminer la réponse en conséquence.

Indicateurs de flux et de frappe

OpenClaw prend en charge les réponses partielles en continu sur Telegram. Avec canaux.telegram.streaming fixé à partiel fido progrès, La passerelle envoie un message temporaire et l'édite au fur et à mesure que le modèle génère du texte. L'utilisateur bénéficie ainsi d'une meilleure expérience pour les réponses longues. Tu peux même activer la sortie de raisonnement en temps réel via l'option /reasoning stream au cours d'une conversation. Les indicateurs de frappe sont envoyés automatiquement, y compris dans les fils de discussion ; cependant, pour le fil ID 1 (sujet général), Telegram ignore message_thread_id dans l'action de saisie.

Réactions, autocollants et commandes en ligne

L'API Bot de Telegram prend en charge les réactions aux messages, les autocollants et les boutons en ligne. OpenClaw expose ces fonctionnalités à travers son système d'action :

• Réactions : Le réagir permet à l'agent de réagir à un message avec un emoji. Les notifications de réaction peuvent être configurées via canaux.telegram.reactionNotifications et niveau de réaction, Telegram permet d'activer les notifications pour les messages du bot, tous les messages ou aucun. Notez que Telegram ne fournit pas d'identifiant de thread pour les réactions, qui sont donc toujours acheminées vers le thread principal.
• Autocollants : Activer les actions sur les autocollants en définissant channels.telegram.actions.sticker : true. Les autocollants sont mis en cache localement ; tu peux effectuer une recherche dans le cache à l'aide de la commande recherche d'autocollants et envoyer un autocollant avec autocollant.
• Boutons en ligne : Configurer canaux.telegram.capabilities.inlineButtons pour définir quand les claviers en ligne sont autorisés (off, dm, group, all ou allowlist). Tu peux ensuite envoyer un message avec des boutons en incluant un élément boutons dans le corps de l'action.

Cas d'utilisation du mode Thread

Le mode Thread permet de débloquer des flux de travail puissants qui, autrement, seraient confus ou impossibles dans un seul chat. Voici quelques scénarios pratiques :

1. Coordination multi-projets

Imagine que tu gères plusieurs projets simultanément. Crée un supergroupe Telegram unique et active les sujets du forum. Pour chaque projet, crée un sujet dédié (par ex, Refonte du site web, Campagne de marketing, Corrections de bugs). Lorsque tu envoies un message à ton assistant à l'intérieur d'un sujet, OpenClaw utilise automatiquement une clé de session unique pour ce fil de discussion. Ainsi, lorsque tu poses une question sur “ l'échéance ”, l'assistant sait à quel projet tu fais référence.

2. Fils de discussion privés dans les discussions de groupe

Lors d'une discussion familiale ou d'équipe très animée, tu peux poser une question à ton assistant sans interrompre la discussion principale. Réponds à ton message précédent ou mentionne le robot dans une réponse. message_thread_id, OpenClaw achemine alors la conversation vers un fil de discussion lié à ce message. Tu peux désormais poser des questions de suivi telles que “ Quelle est ma liste de tâches ? ” ou “ Résume les messages d'aujourd'hui ” sans spammer le chat principal.

3. Tâches de longue haleine

Certaines tâches prennent du temps : résumer un long document, générer un rapport ou exécuter un script. Le fait de lancer ces tâches dans un fil de discussion permet d'organiser les mises à jour de l'état d'avancement. Ensemble canaux.telegram.streaming à progrès l'assistant envoie donc un message de prévisualisation et le modifie jusqu'à ce que le résultat final soit prêt. Si tu as plusieurs tâches longues, chaque fil de discussion reste isolé, ce qui évite les interférences.

4. Séances de remue-méninges

Les sujets du forum peuvent servir de salles de brainstorming. Par exemple, ouvrez un sujet intitulé Idées de blogs et de réfléchir à des idées d'articles avec ton agent. L'assistant conserve le contexte des suggestions précédentes dans le fil de discussion, ce qui permet d'affiner et de développer plus facilement les idées. Pendant ce temps, ta discussion générale reste dégagée.

5. Assistance à la clientèle ou FAQ

Si tu gères un chat communautaire, tu peux créer des sujets pour différentes questions d'assistance. Les utilisateurs posent des questions dans leurs propres fils de discussion et ton agent OpenClaw répond avec des informations personnalisées. Les clés de session étant spécifiques à chaque fil de discussion, l'agent ne mélangera pas les réponses. Tu peux même déléguer des tâches : l'agent peut déposer des problèmes dans GitHub ou créer des événements de calendrier comme actions de suivi.

Dépannage et conseils

Mode de confidentialité : Les robots de Telegram sont par défaut en mode confidentialité, ce qui signifie qu'ils ne voient que les messages commençant par / ou les mentionner. Si tu as besoin d'une visibilité totale des messages dans un groupe, désactive la confidentialité via /setprivacy ou faire du robot un administrateur. N'oubliez pas de supprimer et de réinsérer le robot pour que les modifications soient prises en compte.

Limites de l'histoire : OpenClaw stocke un historique limité par chat ou fil de discussion (50 messages par défaut pour les groupes et configuré via channels.telegram.historyLimit). Augmente cette limite si ton agent a besoin de plus de contexte, mais fais attention à l'utilisation de la mémoire.

Webhook vs long polling : Par défaut, OpenClaw utilise le polling long, qui est plus facile à mettre en place. Si tu veux utiliser des webhooks (par exemple, pour réduire la latence), définis l'option canaux.telegram.webhookUrl et webhookSecret. Consultez la documentation pour connaître les options de port et d'hôte.

Balises de réponse explicites : Utilisation [[reply_to_current]] fido [[reply_to:]] dans les réponses de ton agent lorsque tu as besoin d'un contrôle fin sur les cibles de réponse. Ceci est particulièrement utile pour les bots qui surveillent plusieurs threads simultanément.

Gestion de l'accès : Utilisation canaux.telegram.allowFrom et politique de groupe pour limiter les personnes qui peuvent parler à ton robot et les groupes auxquels il peut adhérer. Cela permet d'éviter le spam et les commandes non autorisées.

Conclusion

Telegram est l'une des plateformes les plus polyvalentes pour faire fonctionner un agent OpenClaw. En comprenant le fonctionnement du mode fil de discussion et en configurant correctement les groupes et les DM, tu peux créer des conversations riches et multi-contextes qui restent organisées. Utilise les fils de discussion pour séparer les projets, exécuter des tâches de longue haleine, faciliter le brainstorming ou fournir une assistance à la clientèle. Tire parti de fonctionnalités telles que les aperçus en continu, les boutons en ligne et les notifications de réaction pour créer une expérience attrayante. Avec la bonne configuration, ton assistant OpenClaw se sentira comme un participant naturel dans ta communauté Telegram.