Canal WhatsApp OpenClaw

OpenClaw se connecte à WhatsApp via la bibliothèque Baileys — une implémentation open-source par ingénierie inverse du protocole multi-appareils de WhatsApp Web. Contrairement à l'API WhatsApp Business officielle (qui nécessite l'approbation de Meta et facture par conversation), Baileys se connecte directement en émulant un appareil associé. L'architecture est simple : votre téléphone reste l'appareil principal, et le Gateway agit comme un appareil compagnon associé. Les messages transitent par les serveurs de WhatsApp comme d'habitude — OpenClaw intercepte simplement les messages entrants, les traite avec votre IA, et renvoie les réponses.

Un numéro de téléphone dédié est fortement recommandé. Bien que vous puissiez utiliser votre numéro personnel, mélanger conversations personnelles et bot crée de la confusion de routage et peut déranger vos contacts. Vous avez besoin d'un vrai numéro de téléphone capable de recevoir des SMS ou appels vocaux pour l'enregistrement initial WhatsApp. Une fois enregistré, le numéro doit simplement rester actif sur un téléphone avec WhatsApp installé.

{
  "channels": {
    "whatsapp": {
      "accounts": {
        "default": {
          "phone": "+15551234567"
        }
      }
    }
  }
}

Après avoir configuré votre canal, vous devez associer votre téléphone au Gateway. Exécutez la commande de connexion et un QR code apparaîtra dans votre terminal. Scannez-le avec WhatsApp sur votre téléphone (Paramètres → Appareils associés → Associer un appareil). Les identifiants sont automatiquement sauvegardés dans ~/.openclaw/credentials/whatsapp/<accountId>/creds.json et persistent après les redémarrages. Une sauvegarde (creds.json.bak) est automatiquement créée pour la récupération en cas de corruption. Vous n'avez besoin de scanner le QR code qu'une seule fois, sauf si la session expire ou est révoquée manuellement.

openclaw channels login whatsapp

Les politiques de DM (Messages Directs) contrôlent qui peut interagir avec votre assistant IA. OpenClaw prend en charge quatre politiques : • pairing (par défaut) — Les nouveaux contacts doivent passer par un processus d'association. Ils envoient un message, reçoivent un code d'association, et vous approuvez ou refusez via la CLI. Une fois approuvés, ils peuvent discuter librement. • allowlist — Seuls les numéros de téléphone explicitement listés dans allowFrom peuvent envoyer des messages au bot. Tous les autres sont silencieusement ignorés. • open — Toute personne qui envoie un message au numéro reçoit une réponse. À utiliser avec prudence en production. • disabled — Le traitement des DM est complètement désactivé. Le bot ne répondra à aucun message direct.

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing",
      "allowFrom": ["+15551234567", "+15559876543"]
    }
  }
}

OpenClaw peut participer aux discussions de groupe WhatsApp. Par défaut, le support des groupes est désactivé pour éviter les réponses IA indésirables dans les conversations partagées. Une fois activé, le bot ne répond que lorsqu'il est mentionné par son nom ou déclenché par un mot-clé configuré. Vous pouvez contrôler quels groupes sont actifs et comment le bot est activé.

{
  "channels": {
    "whatsapp": {
      "groupPolicy": "allowlist",
      "groupActivation": "mention",
      "groupAllowList": ["group-jid-1", "group-jid-2"]
    }
  }
}

Vous pouvez configurer si OpenClaw envoie des accusés de lecture (coches bleues) lors du traitement d'un message. Par défaut, les accusés de lecture sont envoyés pour maintenir une conversation naturelle. Désactiver les accusés de lecture peut être utile si vous voulez que le bot paraisse moins « actif » ou si vous traitez les messages de manière asynchrone.

{
  "channels": {
    "whatsapp": {
      "sendReadReceipts": true
    }
  }
}

OpenClaw peut réagir aux messages entrants avec un emoji pour confirmer la réception avant que la réponse IA ne soit prête. C'est utile car les réponses IA peuvent prendre plusieurs secondes, et la réaction informe l'expéditeur que son message a été reçu. Vous pouvez configurer différentes réactions pour les messages directs et les discussions de groupe, ou désactiver entièrement cette fonctionnalité.

{
  "channels": {
    "whatsapp": {
      "ackReaction": {
        "emoji": "👀",
        "direct": true,
        "group": true
      }
    }
  }
}

OpenClaw prend en charge l'envoi de texte, images, documents, audio et vidéo via WhatsApp. Les fichiers médias sont automatiquement gérés — le Gateway les télécharge sur les serveurs de WhatsApp et envoie le type de message approprié. Pour les longues réponses IA, le texte est automatiquement découpé pour respecter les limites de taille des messages WhatsApp. Vous pouvez configurer la taille des fragments et le comportement.

WhatsApp impose des limites de débit sur les appareils associés. Bien qu'il n'y ait pas de limites officiellement publiées pour les comptes personnels, envoyer trop de messages trop rapidement peut déclencher des blocages temporaires ou des restrictions de compte. OpenClaw inclut une limitation de débit intégrée pour protéger votre compte. Les paramètres par défaut sont conservateurs et adaptés à la plupart des cas d'utilisation.

{
  "channels": {
    "whatsapp": {
      "textChunkLimit": 5,
      "mediaMaxMb": 50
    }
  }
}

Vous vous demandez peut-être pourquoi OpenClaw utilise Baileys au lieu de l'API WhatsApp Business officielle (via Twilio, MessageBird, etc.). Voici les raisons : • Coût — L'API Business facture par conversation (environ 0,005 à 0,08 $ par message selon la région). Pour un usage personnel ou en petite équipe, cela s'accumule rapidement. Baileys est gratuit. • Approbation — L'API Business nécessite la vérification Meta, une entreprise enregistrée et l'approbation des modèles de messages. Baileys fonctionne avec n'importe quel compte WhatsApp personnel. • Flexibilité — L'API Business a des exigences strictes de modèles pour les messages sortants et une fenêtre de conversation de 24 heures. Baileys n'a pas de telles restrictions. • Auto-hébergé — Avec Baileys, tout fonctionne sur votre serveur. Aucun fournisseur d'API tiers ne voit vos messages. Le compromis est la fiabilité : l'API Business est officiellement supportée, tandis que Baileys repose sur l'ingénierie inverse et pourrait cesser de fonctionner si WhatsApp modifie son protocole. Pour la plupart des cas d'utilisation auto-hébergés, ce compromis en vaut la peine.