Tutoriel 02 — Intégration Telegram : installez votre assistant IA dans votre messagerie

Objectif : configurer un bot Telegram pour dialoguer avec l'IA depuis votre téléphone, en conversation privée ou en groupe.

Principe de fonctionnement

Une fois la passerelle OpenClaw démarrée, elle écoute plusieurs « canaux ». Le canal Telegram reçoit les messages via l'API Bot (long polling), les transmet à l'agent IA pour traitement, puis renvoie la réponse sur Telegram.

Votre téléphone → Serveurs Telegram → Bot → Passerelle OpenClaw → MiniMax → Réponse

Étape 1 : Créer un bot Telegram

1. Ouvrez Telegram et recherchez @BotFather

2. Envoyez /newbot et suivez les instructions pour choisir un nom et un nom d'utilisateur

3. Récupérez le token, dont le format ressemble à :

   8543054163:AAHc-yE-nfRlbGw1clvW1OwjdMZ6O_j9tWs
   

Étape 2 : Ajouter le token à la configuration

Éditez .env (à la racine du projet ou dans ~/.openclaw/.env) :

TELEGRAM_BOT_TOKEN=votre-token

Ou ajoutez-le directement dans le bloc env de ~/.openclaw/openclaw.json :

{
  "env": {
    "MINIMAX_API_KEY": "${MINIMAX_API_KEY}",
    "TELEGRAM_BOT_TOKEN": "votre-token"
  }
}

Étape 3 : Activer le canal Telegram

Ajoutez la configuration des canaux dans openclaw.json :

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "${TELEGRAM_BOT_TOKEN}"
    }
  }
}

Étape 4 : Redémarrer la passerelle

pnpm openclaw gateway restart

Consultez les logs pour confirmer que le canal Telegram est connecté :

tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i telegram
# Vous devriez voir : Telegram channel connected

Étape 5 : Tester la conversation

1. Ouvrez Telegram et trouvez votre bot

2. Envoyez /start pour l'activer

3. Envoyez un message :

   « Quel temps fait-il aujourd'hui ? Analyse-le pour moi. »

Le bot devrait répondre en quelques secondes.

Utilisation en groupe

1. Ajoutez le bot au groupe et accordez-lui les droits d'administrateur

2. En groupe, mentionnez le bot pour qu'il réponde (comportement par défaut, pour éviter les abus) :

   @nom-de-votre-bot résume la discussion ci-dessus
   

Commandes slash courantes

Envoyez directement dans Telegram :

Questions fréquentes

Que faire si le bot ne répond pas ?

Vérifiez dans l'ordre : ① lancez pnpm openclaw gateway status pour confirmer que la passerelle fonctionne ; ② consultez les logs tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i telegram pour confirmer la connexion du canal ; ③ en conversation privée, vous devez d'abord envoyer /start pour activer le bot — les messages envoyés avant activation sont ignorés.

Que faire si le bot répond à tort en groupe ?

OpenClaw répond par défaut uniquement aux messages qui le mentionnent, pour éviter le spam. Si le bot répond à des messages qu'il ne devrait pas, vérifiez channels.telegram.replyToMode dans openclaw.json et définissez-le sur "mention".

Le bot Telegram peut-il servir plusieurs utilisateurs simultanément ?

Oui. Le canal Telegram d'OpenClaw supporte la concurrence multi-utilisateurs par défaut. Chaque utilisateur dispose d'un contexte de session indépendant. Tous partagent le même quota de clé API — surveillez la consommation.

Le bot peut-il envoyer et recevoir des images et des fichiers ?

L'envoi et la réception d'images nécessite la configuration d'un modèle de vision (comme MiniMax VL-01), voir le tutoriel 07. La prise en charge des fichiers dépend de la version d'OpenClaw ; utilisez /status pour afficher les capacités actuelles.

Comment utiliser le même bot sur plusieurs appareils ?

Le token du bot est configuré une seule fois dans openclaw.json. Tous les appareils connectés à votre compte Telegram peuvent dialoguer avec le même bot. Les sessions sont isolées par chat_id et ne se perturbent pas.

Prochaines étapes

• Tutoriel 03 — Écrire votre propre Skill pour ajouter de nouvelles capacités à l'IA
• Tutoriel 04 — Laisser l'IA automatiser la navigation web pour vous