OpenClaw WhatsApp : guide complet de l'intégration, de la configuration à la pratique

Parler à une IA dans WhatsApp, c’est utiliser votre messagerie quotidienne pour appeler l’assistant directement, sans changer d’application. L’intégration WhatsApp est un peu plus complexe que Telegram, mais une fois le principe compris, la configuration prend 5 à 10 minutes.

Guide économique « élever un homard » : ArkClaw démocratise l’agent IA

OpenClaw (homard) est puissant mais la config rebute ? ArkClaw de ByteDance Volcano Engine abaisse la barrière : pas de serveur ni de token à bricoler, un assistant 24h/24 qui contrôle le navigateur, exécute des scripts et gère l’agenda.

Le prix compte : 9,9 ¥/mois, code d’invitation ZLKUK54M (inscription) → 8,9 ¥. Développeurs : Coding Plan Pro peut offrir l’accès.

Pourquoi connecter une IA sur WhatsApp ?

Avant de commencer, vous vous demandez peut-être : pourquoi ne pas utiliser Telegram ou l’interface Web directement ?

Chaque plateforme a ses atouts. Pour ma part, j’ai choisi WhatsApp pour ces raisons :

• Habitude d’usage : WhatsApp est ma messagerie principale, famille et amis y sont
• Intégration fluide : pas besoin d’ouvrir une app IA dédiée, tout se passe dans le chat
• Linked Devices : la fonction multi-appareils de WhatsApp est mature et la connexion stable
• Confidentialité maîtrisée : les données restent sur votre serveur, sans passer par un tiers

Telegram a aussi ses avantages : API plus ouverte, écosystème de bots plus riche. Le choix dépend de votre usage.

Préparation : vérifier votre environnement

Avant de connecter WhatsApp, confirmez quelques prérequis :

Conditions indispensables

1. OpenClaw installé et en cours d’exécution — si ce n’est pas fait, consultez le guide d’installation
2. Compte WhatsApp sur le téléphone — compte principal, pour le scan de liaison
3. Gateway actif — assurez-vous que openclaw gateway est démarré
4. Réseau stable — connexion fluide requise lors du scan

Note technique

Un détail à garder en tête : avec le runtime Bun, vous pouvez rencontrer des problèmes de compatibilité lors de la connexion WhatsApp ou Telegram. L’équipe recommande Node.js pour le Gateway, plus stable.

Vérifiez votre environnement :

# Vérifier la version Node.js
node --version

# Confirmer que le Gateway tourne
ps aux | grep openclaw

Trois méthodes de connexion

OpenClaw propose trois façons de connecter WhatsApp, par ordre de recommandation.

Méthode 1 : assistant onboard (la plus simple)

La méthode la plus guidée, idéale pour une première configuration.

Si la configuration initiale n’est pas faite, lancez :

openclaw onboard --install-daemon

L’assistant demande quels canaux connecter. Choisissez WhatsApp, puis :

1. Un QR code s’affiche dans le terminal
2. Sur le téléphone : WhatsApp → « Paramètres » → « Appareils connectés »
3. Appuyez sur « Associer un appareil » et scannez le QR code
4. Après le scan, le terminal confirme la connexion

C’est rapide : 1 à 2 minutes. La première fois j’étais un peu tendu de peur que le scan échoue ; en fait, ça a marché du premier coup.

Méthode 2 : commande channels login

Si l’onboard est déjà fait et que vous voulez ajouter WhatsApp seul :

openclaw channels login

Ce qui se passe :

1. Affichage du QR code (terminal ou interface Web)
2. Scan avec WhatsApp
3. Connexion établie, réception des messages

Avantage : rapide et direct, sans repasser par toute la configuration.

Méthode 3 : interface Web (la plus flexible)

Pour un contrôle fin des paramètres, passez par le panneau Web.

Ouvrez le tableau de bord OpenClaw (par défaut http://localhost:18789), puis :

Étape 1 : page de configuration

Allez dans Settings → Config, cliquez sur RAW en haut à droite pour l’éditeur brut.

Étape 2 : ajouter la config WhatsApp

Dans la section channels, ajoutez :

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+8613800138000"],
      "groupPolicy": "allowlist",
      "mediaMaxMb": 50,
      "debounceMs": 0
    }
  }
}

Signification des options :

• dmPolicy : politique des messages privés ; allowlist = uniquement les numéros autorisés
• allowFrom : liste blanche, votre numéro au format international (indicatif pays)
• groupPolicy : politique des groupes ; allowlist est plus sûr
• mediaMaxMb : taille max des fichiers média reçus (Mo)
• debounceMs : délai anti-rebond des messages (ms), souvent 0

Étape 3 : enregistrer et scanner

Cliquez Update en haut à droite, revenez à Channels : un QR code apparaît. Scannez avec WhatsApp.

Configuration détaillée

Approfondissons les paramètres mentionnés.

Gestion des permissions : qui peut écrire à votre IA ?

dmPolicy et groupPolicy sont deux réglages de sécurité essentiels.

dmPolicy (messages privés) — trois options :

• allowlist : seuls les numéros de la liste peuvent envoyer (recommandé)
• denylist : tout le monde sauf la liste noire
• open : tout le monde (déconseillé, sauf si vous savez ce que vous faites)

J’utilise allowlist avec mon numéro et ceux de la famille. L’IA peut accéder au système ; je ne veux pas que des inconnus envoient des messages.

Format des numéros dans allowFrom

Format international avec indicatif :

"allowFrom": [
  "+8613800138000",    // Chine
  "+14155552671",      // États-Unis
  "+447700900000"      // Royaume-Uni
]

N’oubliez pas le + et l’indicatif, sinon le numéro ne sera pas reconnu.

groupPolicy (groupes)

Pour utiliser l’IA dans un groupe WhatsApp, configurez la politique de groupe. Honnêtement, je déconseille d’ouvrir l’IA à tous les groupes, sauf petits groupes de confiance.

Exemple :

"groupPolicy": "allowlist",
"allowFrom": ["ID_du_groupe"]

L’ID du groupe apparaît dans les logs, ou mettez temporairement open, envoyez un message et lisez l’ID dans les logs.

Routage des messages : comment l’IA traite vos messages

OpenClaw route automatiquement les messages WhatsApp vers le modèle IA. Le flux :

1. Vous envoyez un message sur WhatsApp
2. OpenClaw Gateway reçoit le message
3. Vérification que l’expéditeur est sur la liste blanche
4. Si oui, transfert au modèle IA
5. L’IA génère la réponse
6. Envoi de la réponse sur WhatsApp

En général 1 à 2 secondes (selon la latence du modèle).

Fichiers média

mediaMaxMb limite la taille des fichiers reçus. 50 Mo par défaut suffit en pratique.

Types pris en charge :

• Images (JPG, PNG, etc.)
• Fichiers audio
• Documents (PDF, TXT, etc.)

Avec un modèle vision (ex. GPT-4V), l’IA peut analyser le contenu des images.

Scan du QR code en détail

Quelle que soit la méthode, il faut scanner un QR code. Quelques détails utiles.

Côté téléphone

1. Ouvrir WhatsApp
2. Menu « Plus d’options » (trois points)
3. « Appareils connectés » (Linked Devices)
4. « Associer un appareil » (Link a Device)
5. Vérification empreinte ou mot de passe si demandé
6. Pointer la caméra vers le QR code sur l’ordinateur

Côté ordinateur

• Validité du QR : expire en 1-2 minutes ; rafraîchissez si le scan échoue
• Netteté : QR bien visible ; agrandissez la fenêtre du terminal si besoin
• Réseau : téléphone et ordinateur en ligne au moment du scan

La première fois, le QR était flou (police du terminal trop petite) ; après avoir agrandi la fenêtre, ça a fonctionné.

Signes d’une connexion réussie

• Téléphone : OpenClaw apparaît dans « Appareils connectés »
• Terminal : message du type « WhatsApp connected »
• Interface Web : WhatsApp en vert sur la page Channels

Tests et validation

Une fois connecté, testez tout de suite.

Premier message

Envoyez-vous un message, par exemple :

Bonjour, tu m'entends ?

Si la config est correcte, l’IA répond en quelques secondes. La première réponse sur l’écran du téléphone m’a fait sourire — impressionnant.

Différents types de messages

Essayez :

• Texte : poser une question à l’IA
• Image : envoyer une photo pour description (modèle vision requis)
• Document : PDF ou TXT
• Voix : transcription si prise en charge

Consulter les logs

En cas de problème :

# Logs OpenClaw
openclaw gateway --port 18789

Les logs montrent messages reçus, traitement et erreurs.

Dépannage des problèmes courants

L’installation, ça coince parfois. Voici les pièges que j’ai rencontrés.

Problème 1 : aucune réaction après le scan

Causes possibles :

• QR code expiré
• Problème réseau
• Version WhatsApp obsolète

Solutions :

1. Rafraîchir le QR et rescanner
2. Vérifier le réseau téléphone et ordinateur
3. Mettre WhatsApp à jour

Problème 2 : échec de connexion, status=515

Erreur fréquente, documentée officiellement.

Message complet :

WhatsApp login failed: status=515 Unknown Stream Errored (restart required)

Solutions :

1. Settings → Config
2. Cliquer Update (même sans modification)
3. Revenir à Channels et vérifier le statut
4. Si besoin, redémarrer le Gateway

# Redémarrer le Gateway
pkill -f openclaw
openclaw gateway --port 18789

Problème 3 : message envoyé, l’IA ne répond pas

Causes possibles :

• Expéditeur hors liste blanche
• Problème de config du modèle IA
• Clé API invalide

Étapes :

1. Vérifier le format international du numéro
2. Consulter les logs : message bien reçu ?
3. Tester l’IA dans l’interface Web
4. Valider la clé API

Problème 4 : permission refusée

Symptôme : « Permission denied » ou silence

Correctifs :

• Numéro présent dans allowFrom
• Format avec indicatif pays
• Pour un groupe : vérifier groupPolicy

Problème 5 : impossible d’envoyer un média

Causes possibles :

• Fichier au-delà de mediaMaxMb
• Format non pris en charge
• Échec d’upload réseau

Solutions :

• Augmenter mediaMaxMb
• Compresser le fichier
• Vérifier la connexion

Problème 6 : déconnexion après redémarrage du Gateway

Symptôme : après redémarrage PC ou Gateway, WhatsApp déconnecté

Solutions :

1. Reconnexion automatique en principe
2. Sinon : openclaw channels login et rescanner
3. Vérifier que le daemon démarre correctement

Astuces avancées

Une fois le basique en place, quelques réglages supplémentaires.

Multi-appareils

WhatsApp autorise plusieurs appareils liés. Plusieurs machines OpenClaw peuvent se connecter ; les messages se synchronisent.

Attention : un compte WhatsApp ne peut être lié qu’une seule fois à OpenClaw. Pour plusieurs PC, il faut des comptes WhatsApp distincts.

Stratégie de réponse personnalisée

debounceMs limite les appels API si vous envoyez plusieurs messages d’affilée :

"debounceMs": 1000

L’IA attend 1 seconde puis traite le lot.

Filtrage de messages

Dans la config Skills, vous pouvez ignorer certains messages — par exemple ne répondre qu’aux messages commençant par « IA ».

Optimisation des performances

Si le volume est élevé :

• Réduire mediaMaxMb pour économiser la bande passante
• Ajuster debounceMs pour limiter les requêtes
• Choisir un modèle IA plus rapide

Recommandations de sécurité

Après la connexion WhatsApp, quelques points importants :

1. Liste blanche stricte

N’ajoutez que des numéros de confiance dans allowFrom. Ces contacts peuvent, via l’IA, exécuter des commandes système (si les skills le permettent).

2. Vérifier les appareils connectés

Dans WhatsApp → « Appareils connectés », contrôlez régulièrement la liste. Retirez tout appareil inconnu.

3. Confirmation pour les actions sensibles

Pour suppression de fichiers ou modification de config, ajoutez une double confirmation dans les skills.

4. Pas de connexion sur poste public

Cybercafé, bibliothèque : ne scannez pas WhatsApp. Risque de surveillance et de fuite de compte.

5. Mettre OpenClaw à jour

Appliquez les correctifs de sécurité :

npm update -g openclaw
# ou
pnpm update -g openclaw

Pour conclure

Vous devriez maintenant avoir WhatsApp connecté à OpenClaw. Récapitulons le parcours :

WhatsApp vs Telegram : comment choisir ?

Si vous hésitez encore :

Choisissez WhatsApp si :

• WhatsApp est votre messagerie principale
• Vous voulez partager l’IA avec famille et amis
• Vous valorisez la stabilité de Linked Devices

Choisissez Telegram si :

• Vous voulez une API plus ouverte
• Vous comptez sur l’écosystème bots
• Canaux et groupes avancés vous intéressent

Les deux en parallèle, c’est possible : OpenClaw gère plusieurs canaux ; adaptez selon le contexte.

Et ensuite ?

Une fois connecté :

• Explorer les Skills pour enrichir l’IA
• Tester images et documents (multimodal)
• Affiner la logique de réponse
• Développer vos propres plugins si vous le souhaitez

Dernier rappel : WhatsApp est pratique, mais la sécurité compte. Gérez la liste blanche avec soin ; n’ouvrez pas l’IA à des personnes non fiables.

Bon usage — documentation et communauté en cas de question !

---