OpenClaw (homard) est actuellement le projet open source d’agent IA qui connaît la croissance la plus rapide sur GitHub. Il vous permet d’héberger sur votre propre ordinateur un assistant IA privé, toujours en ligne, et de lui parler via des applications de messagerie que vous utilisez déjà au quotidien, comme Telegram, WhatsApp, Discord, etc.
Ce tutoriel vous guide, étape par étape, de zéro : de l’installation à la configuration, jusqu’à l’envoi de votre premier message. L’ensemble dure environ 10 minutes.
Qu’est-ce qu’OpenClaw ? En quoi est-il différent de ChatGPT ?
ChatGPT est un outil de questions-réponses : vous lui posez une question, il vous renvoie une réponse, puis la conversation s’arrête. OpenClaw est un agent IA : vous lui confiez une tâche, il réfléchit de lui-même, appelle des outils, exécute des actions—consulter votre Gmail, regarder votre calendrier, rechercher sur le Web, écrire du code—puis il vous communique les résultats.
La différence la plus importante est la suivante : OpenClaw fonctionne sur votre propre ordinateur, vos données sont entièrement sous votre contrôle et ne sont envoyées vers aucun serveur tiers. Il ne contient aucun modèle d’IA en lui-même : vous devez fournir vous-même une clé API (Anthropic Claude, OpenAI GPT, Google Gemini, etc.). Les frais du modèle sont payés directement par vous au fournisseur.
Préparation avant l’installation
Configuration système requise
macOS, Linux, ou Windows (recommandé : WSL2, plus stable)
Node.js 22.14 ou supérieur (recommandé : Node 24)
Au moins une clé API de modèle IA
Installer Node.js
D’abord, vérifiez si Node.js est déjà installé et si la version convient :
node -v
Si la version est inférieure à v22.14 ou si Node.js n’est pas encore installé, choisissez la méthode d’installation selon votre système :
Obtenir une clé API de modèle IA
OpenClaw prend en charge plusieurs fournisseurs de modèles. Voici les trois choix les plus courants :
Anthropic Claude : allez sur console.anthropic.com pour créer un compte, puis ajoutez une clé dans la page API Keys. Claude Sonnet 4.x est actuellement le choix le plus populaire.
OpenAI GPT : allez sur platform.openai.com et créez une clé API.
Google Gemini : allez sur aistudio.google.com, vous pouvez obtenir gratuitement une clé API.
Copiez et gardez votre clé API à portée de main : elle sera nécessaire pour l’installer tout à l’heure.
Première étape : installer OpenClaw
Sur macOS et Linux, une seule commande suffit :
curl -fsSL | bash
Pour les utilisateurs Windows, exécutez dans PowerShell :
iwr -useb | iex
Une fois l’installation terminée, vérifiez que la commande fonctionne :
openclaw --version
Deuxième étape : lancer l’assistant d’onboarding
Exécutez la commande suivante pour démarrer l’assistant de configuration interactif, tout en faisant démarrer OpenClaw au démarrage du système en tant que service d’arrière-plan :
openclaw onboard --install-daemon
L’assistant vous posera plusieurs questions, dans l’ordre :
Choisir le fournisseur de modèle : sélectionnez celui dont vous venez d’obtenir la clé API (Anthropic, OpenAI, Google, etc.)
Coller la clé API : collez la clé que vous avez copiée
Choisir le modèle : il est recommandé de choisir le dernier modèle principal (par ex. claude-sonnet-4-5)
Choisir le mode d’installation : pour les débutants, sélectionnez QuickStart : il utilisera des valeurs par défaut pour terminer toute la configuration
Le processus dure environ 2 minutes. Dans la plupart des cas, il suffit d’appuyer sur Entrée pour accepter les valeurs par défaut pour les options.
Troisième étape : vérifier que le Gateway fonctionne
openclaw gateway status
Si vous voyez que Gateway écoute sur le port 18789, c’est que l’installation a réussi.
Ouvrez l’interface de contrôle dans le navigateur pour essayer :
openclaw dashboard
Le navigateur s’ouvrira sur le Control UI. Vous pouvez y envoyer directement un message à l’assistant IA pour confirmer que tout fonctionne correctement.
Quatrième étape : connecter Telegram (la méthode la plus rapide pour démarrer)
Telegram est le canal de communication officiel le plus complet pris en charge par OpenClaw, et la configuration est la plus simple : il vous suffit d’un seul Bot Token.
4-1 Demander un Bot Token à BotFather
Ouvrez Telegram, recherchez et ouvrez @BotFather (vérifiez qu’il y a une coche bleue officielle à côté)
Envoyez /newbot
Suivez les instructions pour saisir le nom du bot (nom affiché) et le compte du bot (doit se terminer par bot, par ex. my_ai_assistant_bot)
BotFather vous donnera un Token, au format semblable à 123456789:AAGxxxxxxxxxxxxxxxxx. Copiez-le.
4-2 Configurer le Token
Éditez le fichier de configuration d’OpenClaw (chemin par défaut :
~/.openclaw/config.json5
), puis ajoutez la configuration Telegram :
{ channels: { telegram: { enabled: true, botToken: “collez ici votre Token”, dmPolicy: “pairing”, }, }, }
4-3 Redémarrer le Gateway et apparier
openclaw gateway restart openclaw pairing list telegram
Ensuite, dans Telegram, retrouvez le bot que vous venez de créer et envoyez-lui n’importe quel message : vous recevrez un code d’appairage. Exécutez :
openclaw pairing approve telegram <code d’appairage>
Une fois terminé, envoyez un message à votre bot dans Telegram : vous recevrez la réponse de l’assistant IA.
Questions fréquentes FAQ
Que faire en cas d’erreur de version de Node ?
Exécutez
node -v
pour vérifier la version. Si elle est inférieure à v22.14, réinstallez Node.js en suivant le tableau ci-dessus. Pour les utilisateurs macOS ayant Homebrew installé, exécutez brew upgrade node pour effectuer la mise à niveau.
Le Gateway ne démarre pas ?
Exécutez
openclaw gateway status
pour voir le message d’erreur. La cause la plus fréquente est que le port 18789 est déjà utilisé, ou que le format de la clé API est incorrect. Vous pouvez exécuter openclaw configure pour reconfigurer.
Comment remplacer la clé API ?
Exécutez
openclaw configure
, puis refaites la configuration à l’étape Model/Auth.
Le Token va-t-il brûler en continu ?
Dans le cas par défaut, OpenClaw n’appelle l’API que lorsqu’il reçoit un message, et n’utilise pas le Token inutilement. Mais si vous activez certaines compétences automatiques (Skill) ou des tâches planifiées, il est recommandé de définir une limite de consommation mensuelle dans le back-office du fournisseur de modèle, afin d’éviter les dépassements imprévus.
Et ensuite, que pouvez-vous faire ?
Connecter Gmail et Google Calendar pour que l’assistant gère vos e-mails et votre agenda
Installer des Skills pour étendre les capacités de l’assistant (recherche sur le Web, exécution de code, gestion de la mémoire, etc.)
Déploiement dans le cloud : garder le homard en ligne 24 h/24 via Cloudflare Tunnel (tutoriel avancé, à venir)
Cet article « OpenClaw (homard IA) » : tutoriel complet d’installation 2026—Configurer un assistant IA personnel depuis zéro, connecter Telegram—est apparu en premier sur Lian News ABMedia.
