Comment connecter votre agent IA à Telegram (guide complet)

Pourquoi Telegram ?

Telegram est le canal recommandé pour votre agent OpenClaw pour plusieurs raisons. Il dispose d'une API Bot mature et bien documentée, fonctionne sur toutes les plateformes (iOS, Android, bureau, web), prend en charge la mise en forme des messages, le partage de fichiers et les claviers inline, et la création de bots est entièrement gratuite sans processus d'approbation.

Plus important encore : les messages Telegram entre vous et votre bot sont privés. OpenClaw communique avec les serveurs de Telegram pour délivrer vos messages, mais le modèle IA ne traite que ce que vous envoyez — votre historique de conversation reste sur votre VPS.

Étape 1 : créer votre bot Telegram

Ouvrez Telegram et recherchez @BotFather — le service officiel de création de bots de Telegram. Démarrez une conversation et envoyez :

/newbot

BotFather vous demandera :

1. Un nom pour votre bot — c'est le nom que les gens voient (ex. : "Mon Assistant IA")
2. Un nom d'utilisateur — doit se terminer par "bot" (ex. : "monassistant_bot")

Après confirmation des deux, BotFather vous envoie un token de bot — une longue chaîne comme 1234567890:ABCdefGHIjklMNOpqrSTUvwxYZ. Copiez-le et sauvegardez-le immédiatement.

Étape 2 : configurer la confidentialité du bot

Par défaut, les bots dans les groupes reçoivent tous les messages. Pour un agent personnel, il vaut mieux le maintenir focalisé. Dans BotFather :

/setprivacy

Sélectionnez votre bot et choisissez Enable. Cela signifie que votre bot ne reçoit que les messages qui lui sont adressés (commençant par / ou le mentionnant). Pour un usage personnel en messages directs, ce paramètre n'a aucun effet, mais c'est une bonne pratique.

Pensez également à définir une description et une photo de profil :

/setdescription
/setuserpic

Étape 3 : obtenir votre identifiant Telegram

OpenClaw doit savoir quel compte Telegram est autorisé à interagir avec votre agent — vous ne voulez pas que n'importe qui puisse envoyer des messages à votre IA personnelle. Pour obtenir votre identifiant, ouvrez une conversation avec @userinfobot et envoyez /start. Il vous répond avec votre identifiant numérique.

Notez-le. Lors de l'installation de k-claw, vous fournirez cet identifiant comme utilisateur autorisé.

Étape 4 : installer OpenClaw via k-claw

Avec votre token de bot et votre identifiant prêts, lancez l'installateur de k-claw sur votre VPS :

curl -fsSL https://claw.krokanti.com/install | bash

Lorsque l'installateur vous demande votre canal de messagerie, sélectionnez Telegram. Il vous demandera :

• Votre token de bot (fourni par BotFather)
• Votre identifiant Telegram (fourni par @userinfobot)
• Votre clé d'API IA
• Le modèle IA que vous souhaitez utiliser

L'installateur configure OpenClaw, met en place le service systemd et démarre votre agent automatiquement.

Étape 5 : commencer à discuter

Ouvrez Telegram et recherchez votre bot par son nom d'utilisateur. Envoyez /start pour l'initialiser, puis posez n'importe quelle question :

Quelle est la capitale de l'Australie ?
Résume les points clés du dernier e-mail que je t'ai partagé.
Rappelle-moi demain à 9h de relire la proposition de projet.

Votre agent répond directement dans le chat, le modèle IA traitant chaque message via API et l'historique des conversations stocké en toute confidentialité sur votre VPS.

Commandes utiles du bot

OpenClaw intègre plusieurs commandes que vous pouvez configurer dans BotFather pour une meilleure expérience utilisateur :

/setcommands

Puis collez :

start - Initialiser l'agent
help - Afficher les commandes disponibles
memory - Afficher ce dont l'agent se souvient
clear - Effacer le contexte de conversation
status - Vérifier l'état de l'agent

Dépannage

Problèmes courants après la configuration :

• Le bot ne répond pas : Vérifiez le service systemd — systemctl status kclaw-agent. Cherchez les erreurs dans les logs avec journalctl -u kclaw-agent -n 50.
• Erreur de token invalide : Assurez-vous d'avoir copié le token complet de BotFather sans espaces supplémentaires.
• Erreur d'utilisateur non autorisé : Vérifiez que votre identifiant Telegram correspond à celui fourni lors de l'installation. Les identifiants sont uniquement numériques.
• Limites de débit de l'API : Si vous envoyez beaucoup de messages rapidement, l'API IA peut limiter les requêtes. OpenClaw gère les nouvelles tentatives automatiquement, mais les temps de réponse peuvent temporairement ralentir.

Le tableau de bord de k-claw affiche l'état de votre installation et les logs en temps réel, ce qui facilite le diagnostic de tout problème sans avoir besoin de vous connecter en SSH à votre serveur.