OpenClaw intégration Telegram : guide complet du Bot à la configuration

Vous voulez poser des questions à un assistant IA directement dans Telegram, sans ouvrir le navigateur, vous connecter à un site et attendre le chargement. Avec OpenClaw et un Telegram Bot, c’est faisable en une demi-heure. Pas besoin de développement backend ni de configuration serveur complexe.

Cet article vous guide pas à pas : création du Bot via BotFather, récupération du token, configuration OpenClaw, liste blanche, puis tests. On inclut les pièges rencontrés et une checklist de dépannage. En 30 minutes, un assistant IA personnel disponible 24h/24.

Guide low-cost « élevage de homard » : ArkClaw démocratise les agents IA

OpenClaw (le homard) est puissant mais la configuration rebute ? ArkClaw de ByteDance Volcano Engine abaisse la barrière au minimum. Sans serveur ni configuration de tokens : un assistant 24h/24 qui contrôle le navigateur, exécute des scripts et gère l’agenda, en un clic.

Le prix compte : 9,9 ¥/mois ; avec mon code d’invitation ZLKUK54M (inscrivez-vous ici), seulement 8,9 ¥. Développeurs : le plan Coding Plan Pro inclut l’offre gratuitement.

Préparation : concepts de base

Avant de toucher au clavier, clarifions quelques notions. Ce n’est pas de la théorie gratuite : les comprendre vous évite beaucoup de détours.

Un Telegram Bot n’est pas un compte classique. C’est plutôt une interface de robot automatique : il reçoit des messages et répond, mais ne peut pas initier une conversation. Comme un bot de support : il parle quand on lui parle.

Qui est BotFather ? Le « usine à Bots » officielle de Telegram. Tous les Bots naissent ici. BotFather est lui-même un Bot — on crée et configure ses Bots en dialoguant avec lui.

Le rôle d’OpenClaw ? Pont entre Telegram et les grands modèles (Claude, GPT, etc.). Telegram reçoit le message, OpenClaw le transmet au modèle, puis renvoie la réponse. Vous n’écrivez pas de code applicatif.

Ce qu’il vous faut :

• Un compte Telegram
• OpenClaw installé et en marche (voir la doc officielle ou notre guide d’installation)
• Une clé API modèle (Claude, GPT, Gemini — une offre gratuite suffit pour tester)

Franchement, ce n’est pas lourd. OpenClaw gère plusieurs plateformes (Telegram, WhatsApp, WeCom, etc.) et plusieurs modèles ; une fois la config faite, changer de modèle est simple.

Étape 1 : créer votre Telegram Bot via BotFather

Ouvrez Telegram, cherchez @BotFather, avec le badge bleu vérifié. Méfiez-vous des imitations.

Création en quelques messages :

1. Envoyez /newbot à BotFather
2. Nom d’affichage du Bot (ex. « Mon assistant IA »)
3. Nom d’utilisateur : doit finir par bot et être unique mondialement. J’ai dû essayer trois fois avant de trouver un nom libre

Si « nom déjà pris », ajoutez des chiffres ou vos initiales, ex. MonSuperIA2024Bot.

Le token est l’étape critique. Après création, BotFather envoie une longue chaîne :

123456789:ABCdefGHIjklMNOpqrsTUVwxyz1234567890

Ce token, c’est la clé de votre maison. Des tokens commités sur GitHub public ont déjà vidé des quotas — parfois pour des centaines d’euros. Copiez-le tout de suite dans un gestionnaire de mots de passe, pas dans le chat ni une note cloud.

Config optionnelle mais utile :

• /setdescription — description visible à l’ouverture du Bot
• /setabouttext — texte « À propos »
• /setuserpic — avatar pour un rendu pro

Récupérez aussi votre ID Telegram ! Indispensable pour la liste blanche. Cherchez @userinfobot, envoyez /start, notez l’ID numérique (ex. 123456789).

Railway - Plateforme de déploiement moderne, sans opérations complexes, en ligne en quelques minutes

Commencer →Pub

Étape 2 : configurer le canal Telegram d’OpenClaw

Avec le token en main, on édite surtout un fichier JSON.

Fichier de config. En 2026, le répertoire d’état par défaut est en général ~/.openclaw/, fichier principal openclaw.json. Noms de champs et hiérarchie : documentation officielle Telegram. L’ancien chemin ~/.clawdbot/config/channels.json date d’avant le renommage — migrez si vous l’utilisez encore. En Docker, vérifiez le montage de OPENCLAW_HOME / ~/.openclaw.

Exemple pédagogique (usage solo, allowlist explicite). Les clés et valeurs par défaut (souvent pairing pour les DM) viennent de la doc et du wizard — ne copiez pas une structure obsolète :

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN_HERE",
      "dmPolicy": "allowlist",
      "allowFrom": [123456789]
    }
  }
}

Points alignés sur la doc :

• botToken : token BotFather, sans espace ni retour ligne parasite
• dmPolicy / allowFrom : qui peut envoyer des DM ; en solo, allowlist + votre ID numérique. Avec le pairing par défaut, premier contact → openclaw pairing approve telegram <CODE> (doc officielle)
• enabled : active ou non le canal

Édition du fichier :

Sur Linux ou Mac :

nano ~/.openclaw/openclaw.json

En Docker, éditez le fichier monté (chemin dans le conteneur selon votre compose) :

docker exec -it openclaw sh
vi /root/.openclaw/openclaw.json

Ou directement sur l’hôte dans le volume monté.

Erreurs fréquentes :

• JSON strict : pas de virgule après le dernier élément
• Collage du token avec guillemets ou espaces en trop
• allowFrom est un tableau, même pour un seul utilisateur (formats d’ID : doc officielle)

Ma première config avait une virgule en trop : OpenClaw refusait de démarrer. JSONLint en ligne évite ce genre d’erreur.

Étape 3 : protéger le Bot avec une liste blanche

La liste blanche, c’est non négociable. Token fuité = n’importe qui peut consommer votre quota IA. Un ami a vidé son quota Claude en trois jours.

Pourquoi c’est obligatoire :

• Éviter l’abus de quota (argent réel)
• Limiter la fuite de contenu sensible (travail, clients)
• Maîtriser les coûts (surtout avec GPT-4)

Configuration : ID obtenu via @userinfobot, champs courants sous channels.telegram : allowFrom avec dmPolicy.

Un seul utilisateur (vous) :

"dmPolicy": "allowlist",
"allowFrom": [123456789]

Équipe :

"dmPolicy": "allowlist",
"allowFrom": [123456789, 987654321, 555555555]

ID d’autres personnes :

1. @userinfobot + /start (ou DM au Bot puis openclaw logs --follow pour from.id, recommandé officiellement)
2. Ils vous transmettent l’ID numérique
3. Vous l’ajoutez à allowFrom

Pour une équipe, tenez un tableau ID / nom. Retirez les ID des personnes qui partent.

Mode pairing :

Le DM Telegram est souvent en pairing par défaut : premier message → openclaw pairing approve telegram <CODE> sur la machine Gateway. Pour un accès par ID seul, comme ici : dmPolicy: "allowlist" et allowFrom explicite (doc).

Étape 4 : démarrer OpenClaw et tester

Démarrer Gateway :

Installation locale (après openclaw onboard --install-daemon, vérifiez openclaw gateway status) :

openclaw gateway
# ou service installé :
openclaw gateway start

En développement depuis les sources, cas rare ; au quotidien, suivez la CLI Gateway — pas un npm start inventé.

Docker :

Vultr - Serveur cloud NVMe haute performance, 32 emplacements mondiaux, déploiement Docker en un clic

Voir les tarifs →Pub

docker compose up -d

Vérifier les logs :

docker compose logs openclaw -f

Vous devriez voir quelque chose comme :

[INFO] Loading Telegram channel: telegram-main
[INFO] Telegram bot connected successfully
[INFO] Listening for messages...

En cas d’erreur, notez le message — la checklist plus bas couvre 90 % des cas.

Premier échange :

1. Cherchez votre Bot (nom finissant par bot)
2. Bouton Start
3. Message test : « Bonjour » ou « Hi there »
4. Réponse IA en quelques secondes si tout est bon

La première réponse du Bot reste un petit moment satisfaisant — vous venez de brancher votre propre robot.

Pas de réponse ? Ne réinstallez pas tout de suite : section dépannage ci-dessous.

Checklist de dépannage

Problème 1 : le Bot ne répond à rien

Dans cet ordre :

• OpenClaw tourne-t-il ? docker ps ou ps aux | grep openclaw
• Token correct dans channels.telegram.botToken ?
• Votre ID dans allowFrom (allowlist) ou pairing approuvé ?
• JSON valide ? cat ~/.openclaw/openclaw.json | jq . ou JSONLint
• Clé API IA valide et quota disponible ?

docker compose logs openclaw -f
cat ~/.openclaw/openclaw.json | jq .

Problème 2 : « Unauthorized » ou « Forbidden »

Souvent la liste blanche :

• Sous dmPolicy: "allowlist", votre ID est-il dans allowFrom ? (formats avec préfixe possibles — doc)
• En pairing : openclaw pairing approve telegram <CODE> fait ?
• Redémarrage après modification

Problème 3 : réponses lentes

• Latence API modèle (heures de pointe)
• Réseau hôte ↔ fournisseur
• CPU / RAM insuffisants

Pistes : modèle plus rapide (GPT-3.5, Claude 3 Haiku), meilleur réseau ou machine plus costaud.

Problème 4 : config modifiée sans effet

Oubli de redémarrage — classique.

docker compose restart
# ou
systemctl restart openclaw

Problème 5 : historique des conversations

• Fichiers de logs (chemin par défaut)
• Control UI si activé
• Base locale (SQLite ou autre selon config)

Problème 6 : token fuité

1. /revoke dans BotFather
2. /token pour un nouveau secret
3. Mettre à jour openclaw.json
4. Redémarrer
5. Contrôler la consommation chez le fournisseur IA

Configuration avancée (optionnel)

Menu de commandes :

Dans BotFather, /setcommands par exemple :

start - Démarrer la conversation
help - Aide
clear - Effacer l'historique

Les utilisateurs voient ces entrées en tapant /.

Pairing DM :

🔥 Ne perdez plus des mois sur des produits sans demande ! Validez vos promesses SaaS avec Adsterra à petit budget →

Tester l'MVP →Pub

Pour plusieurs utilisateurs sans gérer la liste à la main :

"enableDmPairing": true

Code de pairing à la première utilisation — pratique si vous exposez le Bot à d’autres.

Modèles différents par utilisateur :

Admins en GPT-4, autres en GPT-3.5 — voir Multi-Model dans la doc.

Skills OpenClaw :

Fichiers, shell, recherche web, code — puissant mais exec shell = risque élevé, à activer avec prudence.

Mémoire et personnalisation :

Historique, longueur de mémoire, prompts système — pour un assistant qui vous correspond.

Détails dans la doc officielle si vous allez plus loin.

Conclusion

De BotFather au token, config OpenClaw, liste blanche et test : une demi-heure suffit en général.

Rappels des erreurs classiques :

• Token secret, jamais sur un dépôt public
• Liste blanche = sécurité, ne la sautez pas
• JSON strict, une virgule en trop casse tout
• Redémarrer après chaque changement de config

Si vous avez suivi ce guide, vous devriez avoir un assistant IA Telegram opérationnel. Plus besoin d’ouvrir le navigateur à chaque question.

Ensuite :

• Tester plusieurs modèles
• Explorer les Skills
• Étendre à l’équipe

OpenClaw couvre aussi WhatsApp, WeCom, etc. La méthode Telegram se transpose.

En cas de blocage, revenez à la checklist ou à la communauté OpenClaw. Chaque problème résolu en apprend un peu plus.

Allez discuter avec votre assistant !