Comment creer un bot Telegram IA avec OpenClaw (guide etape par etape 2026)

Telegram compte plus de 950 millions d'utilisateurs actifs par mois, et son Bot API est l'une des plus puissantes de toutes les plateformes de messagerie. Combinez-le avec OpenClaw, l'assistant IA open-source qui depasse les 140 000 etoiles sur GitHub, et vous obtenez un agent IA personnel qui vit directement dans votre application de messagerie preferee.

Mais tout configurer depuis zero ? Cela implique des serveurs, Docker, des cles API, des fichiers de configuration et une maintenance continue. Ce guide vous accompagne a travers chaque etape de la creation d'un bot Telegram IA avec OpenClaw, du zero a un assistant fonctionnel. On couvre aussi les astuces de configuration, des cas d'usage concrets, et une alternative plus rapide si vous preferez eviter le DevOps.

---

Ce dont vous avez besoin avant de commencer

Avant de plonger dans l'installation, assurez-vous d'avoir ces prerequis :

Materiel et logiciels :

• Un serveur ou VPS avec consultez la doc officielle pour les specs actuelles (Hetzner, DigitalOcean, ou tout VPS Linux)
• Docker et Docker Compose installes
• Un terminal avec acces SSH a votre serveur
• Node.js 22+ (si vous utilisez OpenClaw sans Docker)

Comptes et tokens :

• Un compte Telegram (numero de telephone requis)
• Une cle API de modele IA (OpenAI, Anthropic, Google, ou tout fournisseur compatible OpenAI)
• Un compte GitHub (optionnel, pour cloner le repo)

Estimation du temps :

• Installation technique : 30-60 minutes
• Configuration et tests : 30 minutes
• Total : environ 1 a 2 heures pour un developpeur

Si ca vous semble beaucoup, passez directement a la section alternative en 60 secondes.

---

Etape 1 : Creer votre bot Telegram avec BotFather

Chaque bot Telegram commence avec @BotFather, l'outil officiel de creation de bots de Telegram.

1. Ouvrez Telegram et cherchez @BotFather (reperable a la coche bleue)
2. Envoyez /start pour voir les commandes disponibles
3. Envoyez /newbot et suivez les instructions :
   • Choisissez un nom d'affichage (ex : "Mon Assistant IA")
   • Choisissez un nom d'utilisateur finissant par bot (ex : monassistant_ia_bot)
4. Sauvegardez votre token immediatement. Il ressemble a : 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

Reglages BotFather importants a configurer :

• /setprivacy - Mettez sur OFF pour que votre bot puisse lire tous les messages de groupe (requis pour le support groupe d'OpenClaw)
• /setjoingroups - Mettez sur Allow si vous voulez le bot dans les groupes
• /setdescription - Ajoutez une description pour que les utilisateurs sachent ce que fait votre bot
• /setabouttext - Info breve visible sur le profil du bot

Gardez votre token en securite. Toute personne avec ce token peut controler votre bot. S'il est compromis, utilisez /revoke dans BotFather pour en generer un nouveau.

---

Etape 2 : Configurer votre serveur

Vous avez besoin d'un serveur qui tourne 24h/24 pour que votre bot reste en ligne. Voici les options les plus courantes :

Option A : Docker (Recommande)

# Connexion SSH a votre serveur
ssh user@votre-ip-serveur

# Creer un repertoire pour OpenClaw
mkdir openclaw && cd openclaw

# Creer docker-compose.yml
cat > docker-compose.yml << 'EOF'
services:
  openclaw:
    # Use the official docker-setup.sh script instead
    container_name: openclaw
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    environment:
      - TELEGRAM_BOT_TOKEN=votre_token_ici
    ports:
      - "18789:18789"
EOF

# Demarrer OpenClaw
docker compose up -d

Option B : Installation manuelle

# Cloner le repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Installer les dependances
npm install -g openclaw

# Demarrer le gateway
openclaw start

Verifier que ca fonctionne

# Verifier les logs Docker
docker logs openclaw --follow

# Ou en mode manuel
openclaw logs --follow

Vous devriez voir le gateway demarrer et se connecter a Telegram. Si vous voyez 401 Unauthorized, reverifiez votre token.

---

Etape 3 : Configurer le canal Telegram

OpenClaw utilise un fichier de configuration JSON pour gerer les canaux. Voici la configuration Telegram essentielle :

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
      "dmPolicy": "pairing",
      "allowFrom": ["votre_id_telegram"]
    }
  }
}

Comprendre les politiques de DM

OpenClaw propose plusieurs modes de controle d'acces :

Trouver votre ID utilisateur Telegram

La methode la plus simple :

1. Envoyez un message a votre bot
2. Consultez les logs OpenClaw : openclaw logs --follow
3. Cherchez from.id dans le message entrant

Ou utilisez directement l'API Bot :

curl "https://api.telegram.org/bot<votre_token>/getUpdates"

---

Etape 4 : Connecter votre modele IA

OpenClaw supporte pratiquement tous les modeles IA. Configurez votre fournisseur prefere :

OpenAI (GPT-4o, GPT-4.1)

{
  "models": {
    "default": "openai/gpt-4o",
    "providers": {
      "openai": {
        "apiKey": "sk-votre-cle-openai"
      }
    }
  }
}

Anthropic (Claude)

{
  "models": {
    "default": "anthropic/claude-sonnet-4-20250514",
    "providers": {
      "anthropic": {
        "apiKey": "sk-ant-votre-cle"
      }
    }
  }
}

Google (Gemini)

{
  "models": {
    "default": "google/gemini-2.5-pro",
    "providers": {
      "google": {
        "apiKey": "votre-cle-google"
      }
    }
  }
}

Vous pouvez aussi utiliser des modeles locaux via Ollama ou tout endpoint compatible OpenAI.

---

Etape 5 : Tester votre bot

Tout est configure, place aux tests :

1. Ouvrez Telegram et trouvez votre bot par son nom d'utilisateur
2. Envoyez /start pour lancer la conversation
3. En mode pairing, entrez le code d'appairage affiche dans les logs serveur
4. Envoyez un message comme "Bonjour, que sais-tu faire ?"
5. Votre assistant IA devrait repondre en quelques secondes

Verification rapide

Lancez ces commandes pour verifier que tout fonctionne :

# Verifier le statut du gateway
openclaw gateway status

# Voir les logs en temps reel
openclaw logs --follow

# Lancer les diagnostics
openclaw gateway status

Si quelque chose ne va pas, Consultez les logs avec openclaw logs --followet verifiez votre configuration dans~/.openclaw/openclaw.json`.

---

Etape 6 : Configurer le support des groupes

L'un des points forts d'OpenClaw est l'integration dans les groupes Telegram. Votre bot peut participer aux conversations d'equipe, repondre aux questions et executer des automatisations pour tout le groupe.

Activer l'acces aux groupes

{
  "channels": {
    "telegram": {
      "groups": {
        "*": {
          "groupPolicy": "open",
          "requireMention": true
        }
      }
    }
  }
}

Parametres cles

• requireMention : Quand true, le bot ne repond que lorsqu'il est mentionne avec @nomdubot. Mettez false pour qu'il reponde a chaque message.
• groupPolicy : Controle qui peut interagir dans les groupes. open autorise tout le monde, allowlist restreint a des utilisateurs specifiques.
• Topics de forum : OpenClaw isole automatiquement les conversations par topic dans les groupes forum Telegram.

Obtenir l'ID du groupe

Pour restreindre l'acces a des groupes specifiques :

1. Ajoutez votre bot au groupe
2. Transferez un message du groupe a @userinfobot
3. Ou verifiez chat.id dans les logs OpenClaw

---

Astuces de configuration avancees

Prompt systeme personnalise (personnalite)

Donnez a votre bot une personnalite unique avec un prompt systeme :

{
  "agents": {
    "defaults": {
      "systemPrompt": "Tu es un assistant professionnel pour Acme Corp. Tu te specialises dans le support client, la planification et les informations produit. Sois toujours professionnel mais amical."
    }
  }
}

Activer les skills et outils

Les skills OpenClaw etendent les capacites de votre bot bien au-dela du simple chat :

• Navigation web : Rechercher sur internet et resumer les resultats
• Gestion de calendrier : Consulter les plannings et creer des evenements
• Email : Lire et rediger des emails
• Gestion de fichiers : Traiter des documents, images et tableurs
• Skills personnalisees : Creez vos propres integrations

Limitation de debit et securite

Pour les deployments en production :

{
  "agents": {
    "defaults": {
      "maxConcurrent": 3
    }
  },
  "channels": {
    "telegram": {
      "dmPolicy": "allowlist",
      "allowFrom": ["user_id_1", "user_id_2"]
    }
  }
}

Configuration multi-comptes

Faites tourner plusieurs bots depuis une seule instance OpenClaw :

{
  "channels": {
    "telegram": {
      "accounts": {
        "default": {
          "token": "token_bot_principal",
          "allowFrom": ["admin_id"]
        },
        "support": {
          "token": "token_bot_support",
          "allowFrom": ["*"]
        }
      }
    }
  }
}

---

Cas d'usage concrets

Pour les chefs d'entreprise

• Bot de support client : Repondre aux FAQ 24h/24, gerer les demandes courantes, escalader les cas complexes vers un humain
• Prise de rendez-vous : Laissez vos clients reserver directement via Telegram
• Suivi de commandes : Connectez votre plateforme e-commerce et donnez aux clients des mises a jour en temps reel
• Qualification de leads : Posez des questions de qualification aux prospects et routez les leads chauds vers votre equipe commerciale

Pour les solopreneurs et freelances

• Assistant personnel : Gerez votre calendrier, redigez des emails et organisez vos taches depuis votre telephone
• Communication client : Offrez un canal de support professionnel alimente par l'IA sans embaucher de personnel
• Creation de contenu : Brainstormez des idees, redigez des posts pour les reseaux sociaux et faites des recherches en deplacement
• Rappels de factures : Automatisez les relances aupres des clients qui n'ont pas paye

Pour les equipes et communautes

• Base de connaissances d'equipe : Votre bot se souvient des conversations passees et peut retrouver des informations pour n'importe qui dans le groupe
• Resumes de reunions : Obtenez des resumes generes par l'IA des discussions de groupe
• Assistant d'onboarding : Aidez les nouveaux membres a trouver des informations et a se mettre a jour
• Aide a la moderation : Signalez le contenu inapproprie ou repondez aux questions repetitives automatiquement

Pour les developpeurs

• Assistant de code review : Collez des extraits de code et obtenez un retour instantane
• Bot de documentation : Interrogez la doc de votre projet directement dans Telegram
• Notifications de deploiement : Recevez des alertes sur vos pipelines CI/CD, la sante des serveurs et les erreurs
• Test d'API : Testez rapidement des endpoints API et analysez les reponses en langage naturel

---

Le vrai cout de l'auto-hebergement

Avant de vous engager dans le DIY, voici a quoi ressemble vraiment la facture mensuelle :

Le cout cache, c'est votre temps. Mises a jour serveur, maintenance Docker, debug des problemes de connexion a 2h du matin quand un client a besoin d'aide, suivi des releases OpenClaw, monitoring de l'uptime. Pour un developpeur, ca peut etre amusant. Pour un chef d'entreprise, chaque heure passee sur le DevOps est une heure non consacree au chiffre d'affaires.

---

Deployer en 60 secondes avec ClawRapid

Et si vous pouviez sauter toutes les etapes precedentes et avoir un bot Telegram IA fonctionnel en moins d'une minute ?

ClawRapid est un service d'hebergement OpenClaw entierement gere, concu pour les utilisateurs non techniques. Voici comment ca marche :

1. Choisissez votre modele IA (GPT-4o, Claude, Gemini, et plus)
2. Connectez votre Telegram (collez votre token de bot)
3. Cliquez sur Deployer

C'est tout. Pas de serveur, pas de Docker, pas de SSH, pas de fichiers de configuration. Votre bot est en ligne en environ 60 secondes.

Ce que vous obtenez avec ClawRapid :

• Hebergement gere avec 99.9% de disponibilite
• Mises a jour automatiques d'OpenClaw
• Securite pre-configuree (pas de cles API exposees)
• Support humain quand vous en avez besoin
• Tous les canaux supportes : Telegram, WhatsApp, Discord, et plus
• Personnalite IA personnalisee par niche metier

Tarif : 45 euros par mois, forfaitaire. Pas de factures API surprises, pas de couts serveur, pas de frais de maintenance.

Pour les chefs d'entreprise, coachs, agents immobiliers et freelances qui ont besoin d'un bot Telegram IA sans les tracas techniques, ClawRapid est le chemin le plus rapide entre l'idee et un assistant fonctionnel.

---

Resolution des problemes courants

Le bot ne repond pas

1. Verifiez que votre token est correct : openclaw gateway status
2. Verifiez que le gateway tourne : openclaw gateway status
3. Assurez-vous que votre ID Telegram est dans la liste allowFrom
4. Verifiez si dmPolicy est regle sur disabled (passez a pairing ou open)

Erreur 401 Unauthorized

Votre token est invalide. Allez dans BotFather, utilisez /revoke, et generez un nouveau token. Mettez a jour votre configuration et redemarrez OpenClaw.

Le bot ne repond pas dans les groupes

1. Verifiez que /setprivacy est sur OFF dans BotFather
2. Verifiez que groupPolicy n'est pas sur disabled
3. Si requireMention est true, assurez-vous de taguer le bot avec @nomdubot

Reponses lentes

• Verifiez la page de statut de votre fournisseur de modele IA
• Reduisez maxConcurrent si vous etes sur un petit VPS
• Envisagez de passer a un modele plus rapide (ex : GPT-4o-mini pour des reponses rapides)

Coupures de connexion

OpenClaw utilise le long polling par defaut, qui est resilient face a la plupart des problemes reseau. Si vous rencontrez des coupures frequentes :

• Verifiez la stabilite internet de votre serveur
• Assurez-vous que Docker a assez de memoire allouee
• Consultez les logs pour les erreurs de timeout : openclaw logs --follow

---

FAQ

Q : OpenClaw est-il gratuit ? R : Oui, OpenClaw est entierement open-source et gratuit. Cependant, vous devez payer l'hebergement (un VPS) et les appels API du modele IA separement. ClawRapid regroupe tout pour 45 euros par mois.

Q : Quel modele IA fonctionne le mieux avec Telegram ? R : Pour un usage general, GPT-4o offre le meilleur equilibre entre vitesse et qualite. Pour le raisonnement complexe, Claude Sonnet 4 est excellent. Pour les budgets serres, GPT-4o-mini ou Gemini Flash sont rapides et abordables.

Q : Mon bot peut-il gerer plusieurs utilisateurs en meme temps ? R : Oui. OpenClaw isole les sessions par utilisateur et par groupe, donc les conversations ne se melangent jamais. Le parametre maxConcurrent controle combien de requetes sont traitees simultanement.

Q : Le bot fonctionne-t-il dans les groupes Telegram ? R : Absolument. OpenClaw a un support complet des groupes avec des exigences de mention configurables, des politiques par groupe et l'isolation des topics de forum. Voir la section support des groupes ci-dessus.

Q : Puis-je changer de modele IA plus tard ? R : Oui. Vous pouvez changer de modele a tout moment en mettant a jour votre configuration. OpenClaw supporte le rechargement a chaud, donc vous n'avez pas besoin de redemarrer le gateway.

Q : Mes donnees sont-elles privees ? R : En auto-hebergement, toutes les donnees restent sur votre serveur. Avec ClawRapid, vos donnees sont stockees sur des serveurs europeens dedies avec chiffrement au repos. Aucune donnee n'est partagee avec des tiers.

Q : Puis-je utiliser le bot pour mon entreprise ? R : Oui. De nombreuses entreprises utilisent les bots Telegram OpenClaw pour le support client, la generation de leads, la prise de rendez-vous et l'assistance d'equipe interne. Pour un usage professionnel, nous recommandons soit une installation auto-hebergee robuste, soit ClawRapid pour un fonctionnement sans maintenance.

Q : Que se passe-t-il si mon serveur tombe en panne ? R : Votre bot passe hors ligne jusqu'au retour du serveur. Les messages envoyes pendant l'indisponibilite ne sont pas perdus par Telegram, mais votre bot ne les traitera pas tant qu'il ne se reconnecte pas. ClawRapid inclut un basculement automatique et des garanties de disponibilite a 99.9%.

---

Pour conclure

Creer un bot Telegram IA avec OpenClaw vous donne un assistant puissant et personnalisable qui vit la ou vous passez deja votre temps. Que vous automatisiez le support client pour votre entreprise ou que vous creiez un compagnon IA personnel, la combinaison de la portee de Telegram et des capacites d'OpenClaw est difficile a battre.

La voie auto-hebergee vous donne un controle total mais demande des competences techniques et une maintenance continue. Si c'est votre truc, ce guide contient tout ce qu'il vous faut pour demarrer.

Si vous preferez vous concentrer sur votre activite plutot que gerer des serveurs, ClawRapid vous donne le meme resultat en 60 secondes, entierement gere, avec support humain inclus.