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.

---

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

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

---

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 :

1. Le message arrive via le protocole Baileys (une bibliothèque qui reproduit la connexion WhatsApp Web)
2. La Gateway le transmet au modèle IA configuré (Claude, GPT-4, ou Ollama pour du local)
3. Le modèle décide quels outils utiliser (shell, navigateur, fichiers…)
4. Les commandes s’exécutent localement sur votre PC
5. La réponse vous revient sur WhatsApp

---

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

---

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 :

1. Choix du modèle IA — Entrez votre clé API (Anthropic, OpenAI, ou configurez Ollama)
2. Configuration du canal — Sélectionnez WhatsApp, scannez le QR code
3. Skills — Optionnel, vous pouvez les ajouter plus tard
4. Lancement de la Gateway — Le daemon démarre en arrière-plan

---

Connecter WhatsApp

C’est la partie la plus satisfaisante. La connexion WhatsApp fonctionne exactement comme WhatsApp Web :

1. L’assistant de configuration affiche un QR code dans votre terminal
2. Sur votre téléphone, ouvrez WhatsApp → Paramètres → Appareils liés → Lier un appareil
3. Scannez le QR code
4. 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)

Autres canaux disponibles

WhatsApp n’est qu’un des canaux possibles. OpenClaw supporte aussi :

Canal	Protocole utilisé	Difficulté de config
WhatsApp	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

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)

---

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.