Guide de télégramme OpenClaw : installation et configuration complètes du robot

Présentation

Telegram est l’une des meilleures plates-formes pour les robots IA, grâce à son API de robot robuste et à ses fonctionnalités telles que les commandes en ligne, les claviers et la prise en charge des discussions de groupe. L’intégration Telegram d’OpenClaw exploite ces fonctionnalités pour offrir une expérience d’assistant IA puissante et interactive.

Ce guide couvre tout ce dont vous avez besoin pour configurer OpenClaw en tant que bot Telegram, de la création du bot à la configuration des fonctionnalités avancées.

Pour d’autres intégrations d’applications de chat, consultez nos guides :

• Configuration WhatsApp
• Configuration Discord
• Configuration Slack
• Configuration iMessage

Pourquoi Telegram ?

Telegram offre plusieurs avantages aux robots IA :

• API Bot officielle — API robuste et bien documentée
• Commandes en ligne — Actions rapides sans taper
• Claviers personnalisés — Boutons interactifs
• Support de discussion de groupe — Fonctionne dans des groupes et des canaux
• Prise en charge des fichiers — Envoyer/recevoir des documents, des images, de l’audio
• Confidentialité – De meilleurs contrôles de confidentialité que de nombreuses plates-formes

Prérequis

Avant de configurer l’intégration de Telegram :

1. OpenClaw installé — Voir guide d’installation
2. OpenClaw configuré — Exécutez openclaw onboard pour configurer votre modèle d’IA
3. Compte Telegram — Compte Telegram actif
4. Bot Token — Vous le créerez à l’étape suivante

Étape 1 : Créer un robot Telegram

Utilisation de @BotFather

1. Ouvrez Telegram et recherchez @BotFather
2. Démarrez une discussion avec @BotFather
3. Envoyer la commande /newbot
4. Choisissez un nom pour votre bot (par exemple, « Mon assistant OpenClaw »)
5. Choisissez un nom d’utilisateur (doit se terminer par bot, par exemple “myopenclaw_bot”)
6. Copiez le jeton du bot — Vous verrez quelque chose comme :

   123456789:ABCdefGHIjklMNOpqrsTUVwxyz

Important : Gardez le jeton de votre bot secret ! Ne le partagez pas publiquement.

Paramètres du robot (facultatif)

Configurez votre bot avec @BotFather :

• /setdescription — Définir la description du bot
• /setabouttext — Définir le texte
• /setuserpic — Définir la photo de profil du bot
• /setcommands — Définir la liste des commandes (voir ci-dessous)

Définition des commandes du robot

Définissez les commandes que les utilisateurs peuvent voir :

/start - Start chatting with OpenClaw
/help - Get help and commands
/email - Check your email
/calendar - View calendar
/tasks - List tasks
/weather - Get weather
/briefing - Daily briefing

Envoyez /setcommands à @BotFather, puis collez les commandes ci-dessus.

Étape 2 : Configurer OpenClaw

Exécuter la configuration de l’intégration

Démarrez l’intégration de Telegram :

openclaw integrations telegram

Ou utilisez la commande générale d’intégrations :

openclaw integrations
# Select Telegram from the menu

Entrez le jeton du robot

Lorsque vous y êtes invité, collez votre jeton de bot :

Enter your Telegram bot token: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

OpenClaw vérifiera le jeton et se connectera à Telegram.

Vérifier la connexion

Vous devriez voir :

✓ Telegram bot connected successfully!
  Bot username: @myopenclaw_bot
  Start chatting: https://t.me/myopenclaw_bot

Étape 3 : Commencez à discuter

Démarrer une conversation

1. Ouvrez Telegram et recherchez votre bot (par nom d’utilisateur)
2. Appuyez sur « Démarrer » ou envoyez /start
3. Envoyez un message du type « Bonjour, pouvez-vous m’aider ? »

OpenClaw répondra via votre bot !

Tester les commandes

Essayez ces commandes :

• /start – Démarrer la conversation
• /help – Obtenir de l’aide
• /email — Vérifier le courrier électronique (si configuré)
• /calendar — Afficher le calendrier
• /tasks — Liste des tâches

Fonctionnalités avancées

Commandes en ligne

Telegram prend en charge les commandes en ligne qui apparaissent au fur et à mesure que vous tapez :

1. Tapez @yourbotname dans n’importe quelle discussion
2. Tapez une requête comme « météo » ou « e-mail »
3. Sélectionnez parmi les suggestions qui s’affichent

Configurez les commandes en ligne dans OpenClaw :

openclaw config set telegram.inline true

Claviers personnalisés

OpenClaw peut envoyer des claviers personnalisés avec des boutons :

openclaw config set telegram.keyboard true

Exemple de disposition du clavier :

[Email] [Calendar] [Tasks]
[Weather] [Briefing] [Help]

Les utilisateurs peuvent appuyer sur des boutons au lieu de saisir des commandes.

Assistance par chat de groupe

OpenClaw fonctionne dans les discussions de groupe :1. Ajoutez votre bot à un groupe 2. Accorder des autorisations (si nécessaire) 3. Mentionnez le bot ou utilisez les commandes :

• @myopenclaw_bot check email
• /email@myopenclaw_bot

Configurez le comportement du groupe :

openclaw config set telegram.groups.enabled true
openclaw config set telegram.groups.requireMention true

Gestion des fichiers

OpenClaw peut gérer les fichiers envoyés via Telegram :

• Images — Analyser et décrire
• Documents — Lisez des PDF, des documents Word, etc.
• Audio – Transcrire les messages vocaux
• Vidéo – Extraire des informations

Envoyez un fichier à votre bot et demandez à OpenClaw de le traiter.

Options de configuration

Formatage de la réponse

Configurez la manière dont OpenClaw formate les réponses :

openclaw config set telegram.format "markdown"

Possibilités :

• markdown — Mise en forme riche (gras, italique, liens, code)
• html — Formatage HTML
• plain — Texte brut

Limitation du débit

Débit des messages de contrôle :

openclaw config set telegram.rateLimit 30

Limité à 30 messages par minute et par utilisateur.

Paramètres de confidentialité

Configurez la confidentialité :

openclaw config set telegram.privacy.privateOnly true

Répondez uniquement aux messages directs, pas aux discussions de groupe.

Paramètres de notification

Notifications de contrôle :

openclaw config set telegram.notifications.enabled true
openclaw config set telegram.notifications.quietHours "22:00-08:00"

Conseils d’utilisation

1. Raccourcis de commande

Créez des raccourcis pour les tâches courantes :

• /e → Vérifier l’e-mail
• /c → Afficher le calendrier
• /t → Liste des tâches
• /w → Météo

2. Messages programmés

Organisez des briefings programmés :

openclaw config set telegram.schedules.dailyBriefing "08:00"

OpenClaw enverra un briefing quotidien à 8 heures du matin.

3. Prise en charge multi-utilisateurs

OpenClaw prend en charge plusieurs utilisateurs :

• Chaque utilisateur a un contexte distinct
• La mémoire est spécifique à l’utilisateur
• Les réponses sont personnalisées

4. Intégration des canaux

Utilisez OpenClaw dans les chaînes Telegram :

1. Ajouter un bot en tant qu’administrateur à la chaîne
2. Accorder des autorisations de publication
3. Configurer le comportement du canal :

   openclaw config set telegram.channels.enabled true

5. Webhook vs sondage

OpenClaw utilise polling par défaut (vérifie périodiquement les messages). Pour de meilleures performances, configurez les webhooks :

openclaw config set telegram.webhook.enabled true
openclaw config set telegram.webhook.url "https://yourdomain.com/webhook"

Nécessite un serveur accessible au public.

Dépannage

Le robot ne répond pas

Si votre bot ne répond pas :

1. Vérifiez l’état du bot :

   openclaw status

2. Vérifier le jeton :

   openclaw config get telegram.token

3. Vérifier les journaux :

   openclaw logs

4. Test de connexion :

   openclaw test telegram

Jeton invalide

Si vous voyez des erreurs « jeton invalide » :

1. Vérifier le jeton — Vérifiez @BotFather pour le jeton correct
2. Régénérer le jeton — Utilisez /revoke puis /newbot dans @BotFather
3. Mettre à jour le jeton :

   openclaw integrations telegram

Messages non reçus

Si les messages ne sont pas reçus :

1. Vérifiez que le bot est en cours d’exécution :

   openclaw status

2. Redémarrez OpenClaw :

   openclaw restart

3. Vérifiez le réseau — Assurez-vous qu’OpenClaw peut atteindre l’API Telegram

Problèmes de discussion en groupe

Si le bot ne fonctionne pas en groupe :

1. Vérifier les autorisations — Le robot a besoin d’autorisations de message

2. Activer la prise en charge de groupe :

   openclaw config set telegram.groups.enabled true

3. Requiert une mention :

   openclaw config set telegram.groups.requireMention true

Limitation du débit

Si vous atteignez les limites de débit :

1. Augmenter la limite de taux :

   openclaw config set telegram.rateLimit 60

2. Vérifiez les limites de Telegram — Telegram a des limites de débit API

3. Utilisez des webhooks — Plus efficace que les sondages

Bonnes pratiques de sécurité

Sécurité des jetons de robot

• Gardez le jeton secret — Ne partagez jamais publiquement

• Utiliser des variables d’environnement :

  export TELEGRAM_BOT_TOKEN="your-token"

• Rotation du jeton — Régénérer en cas de compromis :

  /revoke in @BotFather

Paramètres de confidentialité

• Mode privé — Répondez uniquement aux messages directs
• Liste blanche des utilisateurs : restreindre à des utilisateurs spécifiques :

  openclaw config set telegram.allowedUsers ["user1", "user2"]

Confidentialité des données

• Traitement local — Tous les messages traités localement
• Pas de stockage cloud — Sauf configuration explicite
• Stockage sécurisé — Données stockées dans ~/.openclaw## Cas d’utilisation avancés

Collaboration en équipe

Utilisez OpenClaw dans des groupes d’équipe :

• Gestion des tâches – Attribuer et suivre les tâches
• Coordination du calendrier — Planifier les réunions
• Récupération d’informations — Réponses rapides pour l’équipe

Productivité personnelle

Utiliser comme assistant personnel :

• Gestion des e-mails — Consultez et répondez aux e-mails
• Calendrier – Affichez et gérez le calendrier
• Tâches – Suivez les tâches et les projets

Création de contenu

À utiliser pour les flux de travail de contenu :

• Génération de brouillons — Créez des brouillons via Telegram
• Recherche – Recueillir des informations
• Édition – Révisez et modifiez le contenu

Comparaison avec d’autres plateformes

Télégramme contre WhatsApp

• Telegram — Compte de bot séparé, plus de fonctionnalités
• WhatsApp — Utilise un compte personnel, configuration plus simple

Consultez notre guide WhatsApp pour comparaison.

Télégramme contre Discord

• Telegram — Mieux pour un usage personnel, plus simple
• Discord — Meilleur pour les serveurs, plus de fonctionnalités

Consultez notre Guide Discord pour plus de détails.

Prochaines étapes

Maintenant que Telegram est connecté :

1. Explorez d’autres intégrations — WhatsApp, Discord, Slack
2. Configurer les compétences — Bibliothèque de compétences
3. Configurer l’e-mail — Intégration Gmail
4. Lire la FAQ — Questions courantes

Conclusion

L’intégration de Telegram offre l’une des meilleures expériences pour OpenClaw, grâce à l’API de robot robuste de Telegram et à des fonctionnalités telles que les commandes en ligne et les claviers personnalisés. La configuration est simple : créez un bot avec @BotFather, entrez le jeton et commencez à discuter.

Pour plus d’aide, consultez notre page d’intégrations ou notre FAQ. Bonne discussion avec votre assistant IA sur Telegram !