Débloquer la puissance de Telegram avec OpenClaw Thread Mode

4. Ajouter le bot aux groupes et aux sujets

Pour permettre à votre assistant de participer à des discussions de groupe ou à des sujets de forum, ajoutez-le aux groupes Telegram souhaités, puis mettez à 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. Vous pouvez é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émarrez la passerelle et ajoutez à nouveau le bot à chaque groupe si vous avez 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 vous envoyez des messages à la discussion 1, vous devez 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 vos 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 vous préférez que l'assistant réponde directement au message déclencheur, définissez l'option replyToMode à premier ou tous. Vous pouvez également inclure des balises explicites telles que [[reply_to_current]] ou [[reply_to:]] dans la réponse de votre 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 ou 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. Vous pouvez 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 ; vous pouvez 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). Vous pouvez 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

Imaginez que vous gérez plusieurs projets simultanément. Créez un supergroupe Telegram unique et activez les sujets du forum. Pour chaque projet, créez un sujet dédié (par ex, Refonte du site web, Campagne de marketing, Corrections de bugs). Lorsque vous envoyez un message à votre assistant à l'intérieur d'un sujet, OpenClaw utilise automatiquement une clé de session unique pour ce fil de discussion. Ainsi, lorsque vous posez une question sur “ l'échéance ”, l'assistant sait à quel projet vous faites 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, vous pouvez poser une question à votre assistant sans interrompre la discussion principale. Répondez à votre message précédent ou mentionnez le robot dans une réponse. message_thread_id, OpenClaw achemine alors la conversation vers un fil de discussion lié à ce message. Vous pouvez désormais poser des questions de suivi telles que “ Quelle est ma liste de tâches ? ” ou “ Résumez 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 vous avez 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 votre 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, votre discussion générale reste dégagée.

5. Assistance à la clientèle ou FAQ

Si vous gérez un chat communautaire, vous pouvez créer des sujets pour différentes questions d'assistance. Les utilisateurs posent des questions dans leurs propres fils de discussion et votre 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. Vous pouvez 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 vous avez besoin d'une visibilité totale des messages dans un groupe, désactivez 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). Augmentez cette limite si votre agent a besoin de plus de contexte, mais faites 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 vous souhaitez utiliser des webhooks (par exemple, pour réduire la latence), définissez 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]] ou [[reply_to:]] dans les réponses de votre agent lorsque vous avez 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 à votre 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, vous pouvez créer des conversations riches et multi-contextes qui restent organisées. Utilisez 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. Tirez 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, votre assistant OpenClaw se sentira comme un participant naturel dans votre communauté Telegram.