OpenClaw (ex-Clawdbot) : Contrôler son PC par WhatsApp 🦞
Guide complet : installation, configuration et premiers pas avec votre assistant IA personnel
OpenClaw est un assistant IA personnel, open-source et auto-hébergé, qui tourne directement sur votre machine. Vous lui envoyez un message sur WhatsApp (ou Telegram, Discord, Slack, Signal…), et il exécute des actions sur votre PC : chercher un fichier, lancer un script, lire vos mails, automatiser un navigateur. Tout cela sans que vos données quittent votre machine.
Si vous avez cherché « Clawdbot », « Moltbot » ou « piloter son PC à distance avec une IA » et que vous êtes tombé sur des noms différents pour le même projet — c’est normal. Ce guide clarifie tout.
📑 Sommaire
- Qu’est-ce qu’OpenClaw ?
- L’historique : Clawdbot → Moltbot → OpenClaw
- Comment ça marche : la Gateway
- Prérequis
- Installation pas à pas
- Connecter WhatsApp
- Premier message : tester que tout fonctionne
- 10 cas d’usage concrets
- Sécurité : ce qu’il faut savoir
- Combien ça coûte ?
- Dépannage : erreurs fréquentes
- Questions fréquentes (FAQ)
Qu’est-ce qu’OpenClaw ?
OpenClaw est un agent IA auto-hébergé créé par Peter Steinberger (développeur macOS connu dans l’écosystème Apple). Le projet a dépassé les 60 000 étoiles sur GitHub en quelques semaines, ce qui en fait l’un des projets open-source IA les plus populaires de 2025-2026.
Concrètement, OpenClaw fait tourner un daemon local (appelé la Gateway) sur votre ordinateur. Ce daemon :
- Se connecte à vos applications de messagerie (WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Google Chat, Microsoft Teams…)
- Reçoit vos messages et les transmet à un modèle d’IA (Claude, GPT-4, ou un modèle local via Ollama)
- Exécute les actions demandées directement sur votre machine : commandes shell, lecture/écriture de fichiers, contrôle de navigateur, automatisation…
- Vous renvoie la réponse sur votre messagerie
💡 En résumé : OpenClaw transforme WhatsApp (ou toute autre messagerie) en télécommande intelligente pour votre ordinateur. Vous êtes en déplacement, vous envoyez un message, et votre PC exécute la tâche.
Ce qu’OpenClaw peut faire
| Catégorie | Exemples |
|---|---|
| Fichiers | Chercher un document, lire un PDF, organiser des dossiers |
| Terminal | Exécuter des commandes shell, lancer des scripts Python/Bash |
| Emails | Vider la boîte de réception, rédiger et envoyer des mails |
| Navigateur | Ouvrir des sites, remplir des formulaires, extraire des données |
| Calendrier | Consulter et gérer vos événements |
| Domotique | Contrôler des objets connectés (lumières, purificateur d’air…) |
| Dev / Code | Générer du code, construire des sites web, interagir avec GitHub |
| Skills communautaires | Spotify, check-in vol, et 50+ intégrations via ClawHub |
L’historique : Clawdbot → Moltbot → OpenClaw
Si vous avez l’impression que ce projet change de nom tous les mois, vous n’avez pas tort. Voici la chronologie complète :
| Période | Nom | Pourquoi le changement ? |
|---|---|---|
| Prototype initial | WhatsApp Relay | Nom de travail interne, jamais publié officiellement |
| Fin 2025 | Clawdbot | Premier nom public. Explosion virale, 60 000+ ⭐ GitHub |
| ~Début 2026 | Moltbot | Rebaptisé à cause de problèmes de marque déposée avec Anthropic (le « Clawd » était trop proche de « Claude ») |
| Février 2026 | OpenClaw | Nom définitif. « Moltbot » était difficile à prononcer. « OpenClaw » reflète l’open-source + l’héritage « homard » (🦞) du projet |
⚠️ Important : Les commandes CLI clawdbot et moltbot fonctionnent toujours comme alias. Si vous avez déjà une installation sous un ancien nom, pas besoin de tout réinstaller — vos paramètres sont compatibles.
Comment ça marche : la Gateway
Tout repose sur un composant central : la Gateway. C’est un processus (daemon) qui tourne en arrière-plan sur votre machine et qui gère tout le flux de communication.
Voici le schéma simplifié :
📱 WhatsApp / Telegram / Discord / Slack / Signal / iMessage
│
▼
┌───────────────────────┐
│ GATEWAY │
│ (daemon local) │
│ ws://127.0.0.1:18789 │
└───────────┬───────────┘
│
┌────────────┼────────────┐
▼ ▼ ▼
🧠 Cerveau 🖥️ Terminal 🌐 Navigateur
(Claude, (shell, (CDP Chrome,
GPT-4, fichiers, formulaires,
Ollama) scripts) scraping)
Quand vous envoyez un message WhatsApp :
- Le message arrive via le protocole Baileys (une bibliothèque qui reproduit la connexion WhatsApp Web)
- La Gateway le transmet au modèle IA configuré (Claude, GPT-4, ou Ollama pour du local)
- Le modèle décide quels outils utiliser (shell, navigateur, fichiers…)
- Les commandes s’exécutent localement sur votre PC
- La réponse vous revient sur WhatsApp
💡 Point clé : Vos fichiers et données ne quittent jamais votre machine — seuls les prompts textuels sont envoyés à l’API du modèle IA (sauf si vous utilisez un modèle local comme Ollama, auquel cas rien ne sort de votre réseau).
Prérequis
Avant de commencer, assurez-vous d’avoir :
| Élément | Détail |
|---|---|
| OS | macOS, Linux, ou Windows (via WSL2 — fortement recommandé) |
| Node.js | Version 22.12.0 ou supérieure (le script d’installation peut l’installer pour vous) |
| npm | Inclus avec Node.js (pnpm et bun sont aussi supportés) |
| Clé API | Une clé Anthropic (Claude), OpenAI (GPT-4), ou un modèle local Ollama |
| Téléphone | Un numéro WhatsApp (votre numéro personnel ou un numéro dédié) |
| PC allumé | La machine doit rester allumée et connectée à Internet tant que vous voulez utiliser OpenClaw |
💰 Côté budget : OpenClaw lui-même est gratuit (licence MIT). Le coût vient de l’API du modèle IA : comptez entre 10 et 150 €/mois selon votre utilisation. Le créateur recommande Anthropic Pro/Max + Claude Opus 4.6 pour la meilleure expérience. Ollama permet d’utiliser un modèle local gratuitement, mais avec des performances moindres.
Installation pas à pas
Il existe plusieurs méthodes. On commence par la plus simple (recommandée pour 90 % des utilisateurs).
Méthode 1 : Script d’installation automatique (recommandée)
Ouvrez un terminal et tapez :
curl -fsSL https://openclaw.sh | bash
Ce script détecte votre OS, vérifie Node.js, installe OpenClaw et lance l’assistant de configuration (onboarding wizard).
Si vous préférez inspecter le script avant de l’exécuter (bonne pratique de sécurité) :
curl -O https://openclaw.sh cat install.sh # Lisez le contenu bash install.sh # Exécutez si vous êtes satisfait
Méthode 2 : Installation via npm
# Vérifiez d'abord votre version de Node node -v # Doit afficher v22.12.0 ou plus # Installez globalement npm install -g openclaw@latest # Lancez l'onboarding + installez le daemon openclaw onboard --install-daemon
Le flag --install-daemon enregistre OpenClaw comme service système (launchd sur macOS, systemd sur Linux) pour qu’il survive aux redémarrages.
Méthode 3 : Docker
git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm ui:build pnpm build pnpm openclaw onboard --install-daemon
L’assistant de configuration (Onboarding Wizard)
Après l’installation, l’assistant interactif vous guide étape par étape :
- Choix du modèle IA — Entrez votre clé API (Anthropic, OpenAI, ou configurez Ollama)
- Configuration du canal — Sélectionnez WhatsApp, scannez le QR code
- Skills — Optionnel, vous pouvez les ajouter plus tard
- Lancement de la Gateway — Le daemon démarre en arrière-plan
🔑 Astuce : Utilisez la touche Espace pour cocher/décocher les options dans le wizard, puis Entrée pour confirmer. C’est un piège classique pour les débutants.
Connecter WhatsApp
C’est la partie la plus satisfaisante. La connexion WhatsApp fonctionne exactement comme WhatsApp Web :
- L’assistant de configuration affiche un QR code dans votre terminal
- Sur votre téléphone, ouvrez WhatsApp → Paramètres → Appareils liés → Lier un appareil
- Scannez le QR code
- C’est fait : OpenClaw est maintenant connecté à votre compte WhatsApp
OpenClaw utilise la bibliothèque Baileys (un client WhatsApp Web en TypeScript) pour cette connexion. Cela signifie que :
- Vous n’avez pas besoin de l’API WhatsApp Business
- Votre numéro personnel fonctionne
- Vous pouvez aussi utiliser un numéro secondaire (recommandé pour éviter les confusions)
⚠️ Conseil : Si vous utilisez votre numéro personnel, OpenClaw pourrait potentiellement lire vos messages WhatsApp. Par sécurité, envisagez d’utiliser un numéro dédié (une seconde carte SIM, ou un numéro VoIP).
Autres canaux disponibles
WhatsApp n’est qu’un des canaux possibles. OpenClaw supporte aussi :
| Canal | Protocole utilisé | Difficulté de config |
|---|---|---|
| Baileys (QR code) | ⭐ Facile | |
| Telegram | Bot API | ⭐ Très facile |
| Discord | Bot Discord | ⭐ Facile |
| Slack | Slack App | ⭐⭐ Moyen |
| Signal | Signal CLI | ⭐⭐ Moyen |
| iMessage | BlueBubbles / legacy | ⭐⭐⭐ Complexe (macOS uniquement) |
| Microsoft Teams | Teams API | ⭐⭐ Moyen |
Premier message : tester que tout fonctionne
Une fois WhatsApp connecté, envoyez-vous un message à vous-même (ou au numéro dédié). Essayez par exemple :
Bonjour, quel est mon système d'exploitation ?
OpenClaw devrait répondre en quelques secondes avec les informations de votre machine. Si la réponse apparaît :
- ✅ Sur WhatsApp
- ✅ Dans le terminal (TUI)
- ✅ Sur le Control UI (dashboard web accessible via
openclaw dashboard)
…alors tout fonctionne. Vous avez un assistant IA personnel opérationnel en moins de 20 minutes.
Commandes utiles après installation
| Commande | Description |
|---|---|
openclaw status | Vérifier l’état de la Gateway |
openclaw doctor | Diagnostic automatique (configurations, permissions, erreurs) |
openclaw dashboard | Ouvrir le Control UI dans le navigateur |
openclaw tui | Chatter avec votre bot directement depuis le terminal |
openclaw channels | Gérer les canaux de messagerie connectés |
openclaw logs --follow | Voir les logs en temps réel (utile pour le debug) |
openclaw update | Mettre à jour vers la dernière version |
/status | À envoyer dans WhatsApp/Telegram pour voir le statut de la session |
10 cas d’usage concrets
Voici des exemples réels de messages que vous pouvez envoyer à votre OpenClaw par WhatsApp :
| # | Votre message WhatsApp | Ce qu’OpenClaw fait |
|---|---|---|
| 1 | « Trouve le rapport Q4 PDF sur mon bureau » | Parcourt vos fichiers, trouve le bon PDF, vous envoie le chemin |
| 2 | « Résume les 5 derniers mails non lus » | Accède à Gmail, lit les mails, renvoie un résumé |
| 3 | « Lance le script backup.sh » | Exécute le script bash et renvoie le résultat |
| 4 | « Crée un site web one-page pour mon portfolio » | Génère le HTML/CSS, crée les fichiers sur votre machine |
| 5 | « Qu’est-ce que j’ai demain dans mon calendrier ? » | Consulte votre calendrier et envoie l’agenda |
| 6 | « Check-in mon vol Air France AF1234 » | Ouvre le navigateur, fait le check-in automatiquement (via skill) |
| 7 | « Allume les lumières du salon » | Contrôle vos objets connectés (Hue, etc.) |
| 8 | « Quel processus consomme le plus de RAM ? » | Exécute une commande système et renvoie le résultat |
| 9 | « Prends une photo du ciel avec l’iPhone » | Utilise le node iOS/Android pour déclencher la caméra |
| 10 | « Fais une recherche sur le Ralph loop et construis-moi un site résumé » | Recherche web + génération de code + déploiement — tout automatisé |
Sécurité : ce qu’il faut savoir
OpenClaw a un accès direct à votre machine. Cela signifie que la sécurité est critique. Voici les mécanismes en place et les bonnes pratiques :
Protections par défaut
| Protection | Description |
|---|---|
| DM Pairing | Un expéditeur inconnu doit entrer un code de validation avant de pouvoir interagir avec votre bot |
| Mention obligatoire en groupe | Dans les groupes, le bot ne répond que si vous le mentionnez (@) |
| Sandbox | Les sessions non-principales peuvent tourner dans un conteneur Docker isolé |
| Mode consentement | Avec exec.ask: "on", chaque commande nécessite votre approbation manuelle |
| Tool Policy | Permissions granulaires pour chaque outil (lecture seule, exécution, écriture…) |
Ce qu’il ne faut PAS faire
🚫 Erreurs à éviter :
- Activer
dangerously-skip-permissionssans comprendre les conséquences - Exposer le Control UI sur Internet sans authentification
- Installer des skills/plugins tiers non vérifiés
- Ajouter le bot dans des groupes WhatsApp où des inconnus peuvent lui envoyer des instructions
- Laisser tourner OpenClaw sur une machine qui contient des données sensibles (bancaires, médicales…) sans sandbox
La commande openclaw doctor permet de vérifier automatiquement votre configuration et signaler les risques.
Combien ça coûte ?
| Composant | Coût |
|---|---|
| OpenClaw (logiciel) | Gratuit (MIT open-source) |
| Anthropic Claude (API) | ~20–150 €/mois selon usage (ou abonnement Pro/Max ~20-100 $/mois) |
| OpenAI GPT-4 (API) | ~10–100 €/mois selon usage |
| Ollama (modèle local) | Gratuit (mais nécessite un GPU pour les meilleurs modèles) |
| Hardware | Votre PC existant suffit. Certains passionnés achètent un Mac Mini dédié (~700 €) |
Dépannage : erreurs fréquentes
| Erreur | Solution |
|---|---|
command not found: openclaw | Redémarrez le terminal. Si ça persiste, ajoutez le chemin npm global à votre PATH |
Node.js 22+ required | Installez Node 22 via nvm : nvm install 22 && nvm use 22 |
RPC probe: failed | Le port 18789 est déjà utilisé. Trouvez le processus : lsof -i :18789 puis tuez-le |
| Gateway ne répond pas / « 0 tokens used » | Le daemon s’est arrêté ou l’API est invalide. openclaw gateway restart + vérifiez vos clés API |
| QR code WhatsApp expiré | Relancez openclaw onboard (vous pouvez refaire uniquement l’étape canal) |
Erreur sharp ou node-gyp | Forcez les binaires pré-compilés : npm_config_sharp_binary_host="" npm install -g openclaw@latest |
Access not configured | Votre ID utilisateur n’est pas autorisé. Validez l’appairage avec le code affiché par le bot |
En cas de doute : openclaw doctor --fix résout automatiquement les problèmes les plus courants.
Questions fréquentes (FAQ)
C’est quoi la différence entre Clawdbot, Moltbot et OpenClaw ?
C’est le même projet. Clawdbot était le nom original (fin 2025). Il a été rebaptisé Moltbot suite à un problème de marque déposée avec Anthropic (« Clawd » trop proche de « Claude »). Puis renommé OpenClaw car Moltbot était difficile à prononcer. Les commandes CLI clawdbot et moltbot fonctionnent toujours comme alias.
Est-ce qu’OpenClaw est gratuit ?
Le logiciel OpenClaw est gratuit et open-source (licence MIT). En revanche, vous devez payer l’API du modèle d’IA que vous utilisez (Anthropic Claude, OpenAI GPT-4). Comptez entre 10 et 150 €/mois selon votre utilisation. L’alternative gratuite est d’utiliser un modèle local via Ollama, mais les performances seront moindres.
Est-ce qu’OpenClaw peut lire mes messages WhatsApp ?
Oui, potentiellement. OpenClaw se connecte à votre compte WhatsApp exactement comme WhatsApp Web. Il a techniquement accès à vos conversations. C’est pourquoi il est recommandé d’utiliser un numéro de téléphone dédié plutôt que votre numéro personnel, ou de configurer des règles de filtrage strictes.
Est-ce que mon PC doit rester allumé ?
Oui. La Gateway tourne en tant que daemon (service système) sur votre machine. Si votre PC s’éteint ou perd Internet, OpenClaw ne répond plus. Certains utilisateurs investissent dans un Mac Mini ou un petit serveur Linux dédié qui reste allumé en permanence.
Est-ce qu’OpenClaw fonctionne sur Windows ?
Oui, mais via WSL2 (Windows Subsystem for Linux). L’exécution native sous Windows n’est pas officiellement supportée. L’installation sous WSL2 est fortement recommandée et fonctionne très bien. macOS et Linux sont supportés nativement.
Quel modèle IA choisir pour OpenClaw ?
Le créateur recommande Claude Opus 4.6 via un abonnement Anthropic Pro ou Max pour la meilleure expérience (contexte long, résistance aux injections de prompt). GPT-4 fonctionne aussi très bien. Pour une solution 100 % locale et gratuite, Ollama avec un modèle comme Llama 3 est possible mais avec des performances réduites.
Est-ce que c’est sécurisé ?
OpenClaw intègre plusieurs couches de sécurité : appairage par code, sandbox Docker, mode consentement pour les commandes sensibles, et politique d’outils granulaire. Le code est entièrement open-source et auditable. Cependant, un agent avec accès shell et fichiers crée une surface d’attaque réelle. Ne désactivez jamais les permissions sans comprendre les risques, et exécutez openclaw doctor régulièrement.
Liens utiles
| Site officiel | openclaw.ai |
| GitHub | github.com/openclaw/openclaw |
| Documentation | docs.openclaw.ai |
| Discord communautaire | Lien disponible sur le site officiel |
↩️ Revenir à toutes nos fiches programmation
La version PDF de ce guide sera prochainement disponible.