Si OpenClaw tourne déjà sur votre Mac mais que vous dialoguez encore via Telegram ou le web, il manque souvent WeChat comme entrée quotidienne. Depuis mars 2026, l’équipe WeChat publie le plugin officiel WeChat ClawBot : après activation dans Réglages → Extensions, une commande npx sur la machine Gateway et un scan QR suffisent pour brancher votre OpenClaw configuré (personnalité, mémoire, Skills, routage Agent) à une conversation privée WeChat. Ce texte vise les lecteurs ayant fini l’installation de base et visant la production : comparaison plugin officiel versus Wechaty et voies non officielles, puis matrice de décision, runbook en huit étapes, limites produit et conformité, et au moins trois paramètres durs pour les revues de changement. Commandes et seuils de version à vérifier sur Tencent Developer Community et la fiche npm ; rouvrir les liens après chaque release. Tarifs sur la page tarifs, commande sur la page de commande, accès distant dans le centre d’aide.
[ SECTION_01 ] // PAIN_MAP Pièges fréquents en branchant WeChat
- Continuer les protocoles gris : Wechaty, protocole iPad et autres voies non officielles cassent souvent toute la chaîne lors de changements de protocole ou de durcissement du risque, avec incertitude de bannissement ; ce n’est pas le même niveau de risque que l’écosystème plugin officiel.
- Version WeChat insuffisante : l’entrée extension exige un client récent ; iOS au minimum 8.0.70, Android au minimum 8.0.69. Sur une version ancienne, ClawBot n’apparaît pas sous Extensions.
- Scan QR avant Gateway prêt :
npxréussit mais OpenClaw Gateway n’écoute pas ou le démon ne tourne pas. QR expiré donne l’impression « connecté puis coupé ». - Compte principal comme bac à sable : les messages passent par l’infrastructure intérieure et peuvent déclencher la modération. Lier ClawBot au WeChat principal mélange réseau social et expérimentation d’automatisation.
- Supposer groupes et fichiers bidirectionnels : le produit vise le chat privé ; capacités fichiers et règle de silence 24 h sans lecture doc provoquent des échecs dès la première semaine.
- Sommeil du portable : « l’IA ne répond plus » : Gateway sur Mac qui se ferme : l’utilisateur croit ClawBot cassé alors que l’hôte est hors ligne, pas le plugin.
[ SECTION_02 ] // ROUTE_MATRIX WeChat ClawBot perso, WeCom et canaux internationaux
Cette matrice aide à choisir le canal en phase projet et à éviter le retour arrière « installé mais pas de groupe ».
| Voie | Officiel | Usage typique | Limite principale |
|---|---|---|---|
| Plugin WeChat ClawBot | Tencent WeChat officiel | Compte perso, assistant chat privé | Chat privé ; fichiers souvent entrant seul ; long silence peut exiger re-liaison |
| Plugin WeCom OpenClaw | Tencent WeCom officiel | Bot équipe, docs et messages | Config admin WeCom ; produit différent du WeChat perso |
| Wechaty communautaire | Protocole non officiel | Tests historiques, intégrations spéciales | Risque protocole et bannissement incontrôlé, pas défaut prod |
| Telegram / Discord | API Bot plateforme | Collaboration internationale, bots parallèles | Couverture quotidienne en Chine continentale inférieure à WeChat |
Pour les utilisateurs en Chine continentale, ClawBot n’est pas « une fenêtre de plus » mais le moyen de placer la couche d’exécution OpenClaw déjà configurée dans l’IM à plus forte activité — à condition que le Gateway soit stable et auditable, pas sur un portable personnel avec stratégie de veille.
[ SECTION_03 ] // INSTALL_RUNBOOK D’OpenClaw au dialogue WeChat : huit étapes
Étapes compilées à partir des tutoriels Tencent publics et de la commande npm ; si le nom du paquet ou le flux change, la doc officielle prime.
https://developer.cloud.tencent.com/article/2648517
https://openclawlaunch.com/zh/wechat-clawbot
- OpenClaw en permanence : sur le Mac cible,
openclaw onboard --install-daemonou démon équivalent, puisopenclaw doctorpour le port Gateway et PATH ; voir checklist premier run et Gateway. - Mettre à jour WeChat : Moi → Réglages → À propos de WeChat : iOS au minimum 8.0.70, Android au minimum 8.0.69.
- Activer l’extension : Réglages → Extensions, activer « WeChat ClawBot » ; si absent, exclure version et déploiement gris régional.
- Commande d’installation sur l’hôte Gateway : dans le même contexte utilisateur qu’OpenClaw, exécuter la commande ci-dessous (Node et accès npm requis).
- Scan QR en terminal : après affichage du QR, scanner avec WeChat activé et confirmer l’autorisation sur le téléphone.
- Vérifier côté WeChat : ouvrir le dialogue « WeChat ClawBot », envoyer un message test, confirmer que la réponse vient de votre modèle et persona, pas de l’IA WeChat intégrée.
- Redémarrer Gateway et contrôler le routage : après liaison, redémarrage Gateway ou
openclaw gateway restart; valider processus plugin et routage OpenClawresolveAgentRoute(un numéro WeChat peut avoir plusieurs contextes de session, plusieurs numéros peuvent mapper plusieurs Agents). - Journal ops : noter le numéro lié (second compte recommandé), heure de liaison, version npm et baseline disque des logs pour attribution rapide en cas de coupure 24 h ou alerte modération.
$ npx -y @tencent-weixin/openclaw-weixin-cli@latest install[ SECTION_04 ] // LIMITS_AND_OPS Limites produit, multi-Agent et précautions production
Limites (selon doc officielle actuelle) : WeChat ClawBot perso cible le chat privé, texte, image, voix et sous-ensemble fichiers disponibles, mais pas de chat de groupe par défaut ; parfois fichiers entrant seulement ; après environ 24 heures sans dialogue, re-scan possible. Ne pas transposer l’expérience multi-bot Telegram telle quelle sur WeChat.
Multi-Agent : deux schémas recommandés : schéma A — un numéro WeChat, Agent principal délègue aux sub-Agents (une fenêtre, proche des habitudes WeChat) ; schéma B — plusieurs numéros vers Agents distincts (frontières nettes contenu vs ops). Éviter de changer d’Agent manuellement dans la même conversation.
- Second compte : WeChat de réserve pour tests d’automatisation, moindre risque pour le compte principal et la modération.
- Clés et identifiants : clés API modèle et chemins workspace restent sur l’hôte Gateway ; ne pas coller de secrets prod dans le chat.
- Modération de contenu : le trafic passe par l’infrastructure Tencent intérieure ; limiter instructions sensibles et export de données selon conformité équipe et obligations RGPD pour les équipes européennes.
- Disque et journaux : plugin canal et logs Gateway grossissent vite ; prévoir rotation sur Mac distant ; voir plan disque et démon.
- WeCom : scénarios équipe : évaluer en parallèle le plugin WeCom OpenClaw, projet séparé du ClawBot perso.
[ SECTION_05 ] // HARD_FACTS Paramètres citables et erreurs typiques
- Seuil version WeChat : tutoriels publics exigent iOS 8.0.70+, Android 8.0.69+ pour voir ClawBot dans la liste extensions. (Source : article Tencent Cloud 2648517, revérifier après release)
- Commande d’installation officielle :
npx -y @tencent-weixin/openclaw-weixin-cli@latest install, paquet CLI maintenu par l’équipe WeChat. (Source : idem et page OpenClaw Launch WeChat) - Chronologie : plugin WeChat ClawBot publié vers mars 2026, système plugin régulier, pas de hook tiers. (Source : rapports communauté, annonce Tencent fait foi)
- Port Gateway : debug et résidence OpenClaw tournent souvent autour du loopback 18789 ; ClawBot comme entrée canal sur Gateway déjà actif. (Source : openclaw/openclaw README)
| Symptôme | Suspicion | Vérification minimale |
|---|---|---|
| Pas de ClawBot dans extensions | WeChat trop ancien, gris | Mettre à jour ; vérifier version iOS/Android |
| Pas de réponse après scan | Gateway arrêté, npm échoué | lsof -nP -iTCP:18789 -sTCP:LISTEN ; logs Gateway |
| Silencieux le lendemain | Politique 24 h, veille hôte | Re-scanner ; migrer Gateway sur Mac distant 7×24 |
| @ groupe sans réaction | Produit sans entrée groupe | Passer en privé ou voie WeCom |
[ SECTION_06 ] // PLATFORM_CLOSE Pourquoi ClawBot convient à un Mac distant 7×24
ClawBot résout l’entrée ; la stabilité dépend de l’hôte Gateway : Mac perso en veille, NAT domestique et politique de sommeil font paraître WeChat « IA disparue ». Les VPS virtualisés restent en ligne mais s’alignent souvent moins bien sur la toolchain macOS, l’IO disque et les capacités Node OpenClaw qu’un Mac mini nu métallique. Gateway et openclaw-weixin-cli sur Apple Silicon dédié, avec rotation logs et second compte, limitent le risque au niveau produit plutôt qu’« ordinateur portable débranché ».
Pour latence et durée de location sur six régions, ou passage M4 à M4 Pro pour plusieurs Agents et Skills plus lourds : comparer sur la page tarifs NOVAKVM, lancer une machine d’essai sur la page de commande pour deux cycles d’itération. Les studios qui regroupent entrée WeChat, CI iOS et automatisation OpenClaw dans une même frontière ops trouvent souvent la location cloud Mac Mini nu métallique NOVAKVM plus adaptée qu’un PC maison ou des protocoles instables. Accès distant dans le centre d’aide ; canaux et proxy inverse dans dépannage canaux OpenClaw et Gateway.