Plugin WeChat officiel · liaison QR · limites chat privé · Gateway 24/7 · conformité RGPD
Vous voulez brancher le WeChat ClawBot officiel sur votre Gateway OpenClaw — et vous heurtez à des QR expirés, à l'absence de plugin gris ou à des messages qui disparaissent après un redémarrage Gateway. Ce guide s'adresse aux développeurs qui veulent utiliser npx @tencent-weixin/openclaw-weixin-cli en production : d'abord l'architecture (plugin officiel vs pont non officiel), puis les prérequis et la séparation de comptes, enfin un runbook en six étapes pour installation, liaison et recette. À lire avec la checklist installation Gateway et le durcissement multi-canal.
En 2026, Tencent fournit un plugin OpenClaw officiel qui connecte WeChat au même plan de contrôle que Telegram, Discord ou Slack. L'adaptateur canal vit dans le Gateway ; skills, routage de modèles et appels d'outils restent inchangés. Cela distingue ClawBot des ponts Web WeChat non officiels, souvent contraires aux conditions d'utilisation, sans reprise de session propre et inadaptés à la production.
Le paquet @tencent-weixin/openclaw-weixin-cli encapsule l'installation du plugin, la génération QR et la première liaison. OpenClaw gère heartbeats, réception webhook et relais vers l'agent. Si vous utilisez déjà Telegram, WeChat s'ajoute comme second canal — pas en remplacement du durcissement Gateway. Les équipes européennes doivent traiter contenus de chat, métadonnées de contacts et logs d'agent comme données personnelles au sens RGPD : héberger Gateway et journaux sur un nœud dédié documenté limite les flux via des ponts tiers.
Plugin officiel : maintenu par Tencent, couplé aux versions OpenClaw ; mises à jour via npm ou openclaw plugins.
Pont non officiel : risque de bannissement, protocole fragile — expériences uniquement.
Gateway unique : un Gateway, plusieurs canaux ; WeChat partage backend modèle et registre de skills avec Telegram.
Déploiement gris : client WeChat et plugin souvent réservés à des comptes sélectionnés.
Focus chat privé : pas de bot de groupe comme sur Telegram — à figer en revue d'architecture.
Comprendre ces cinq points avant le premier scan QR évite l'erreur la plus fréquente : croire qu'un openclaw doctor vert garantit le gris WeChat et l'accessibilité du téléphone.
Avant d'exécuter npx, validez quatre portes. L'absence de gris est le blocage numéro un — aucun runbook ne compense un compte sans accès plugin.
| Porte | Vérification | Résultat typique |
|---|---|---|
| Client WeChat | Version récente, plugin gris visible | Sans gris : pas de QR ou liaison qui casse |
| OpenClaw | Node 22.14+, openclaw gateway status vert | Gateway actif avant le QR, pas après |
| Stratégie compte | Compte réel vs sous-compte test | Prod : compte dédié ; séparer perso/pro documenté |
| Hôte 24/7 | Portable vs Mac cloud / VPS | Veille du portable tue les callbacks — voir persistance cloud Mac |
WeChat ClawBot n'est pas un jouet « mobile only » : l'hôte Gateway doit rester joignable tant que vous attendez des réponses.
Pour les équipes multi-canaux, un compte WeChat de test dédié, séparé des chats personnels, simplifie conformité interne et documentation RGPD (finalité, durées de conservation des logs Gateway). Le Gateway de production appartient à un nœud 24/7 planifiable ; isolation Docker : baseline Compose.
Deux chemins mènent au même objectif ; choisissez-en un par environnement et documentez-le dans le ticket de changement.
One-shot npx : npx @tencent-weixin/openclaw-weixin-cli install — installe le plugin, lance l'assistant de liaison, affiche le QR.
Manuel étape 1 : openclaw plugins install @tencent-weixin/openclaw-weixin
Manuel étape 2 : redémarrer Gateway — openclaw gateway restart
Manuel étape 3 : openclaw channels add weixin (sous-commande exacte selon l'aide CLI)
Manuel étape 4 : lier le QR et confirmer le premier contact dans WeChat
openclaw gateway status npx @tencent-weixin/openclaw-weixin-cli install openclaw gateway restart openclaw logs --follow
Conseil : avec miroirs npm lents ou proxy d'entreprise, vérifiez le registry avant installation — un plugin à moitié installé produit « Gateway vert, canal mort ».
Le chemin manuel convient au GitOps et aux images Docker où npx à l'exécution est indésirable. Les deux exigent openclaw onboard --install-daemon déjà exécuté — voir la checklist installation.
La recette suit un ordre fixe ; copiez chaque étape dans le ticket.
Générer le QR : respecter la fenêtre de validité ; en cas de timeout, regénérer — ne pas redémarrer Gateway au hasard.
Scanner dans WeChat : confirmer le contact ClawBot officiel ; sans plugin gris, le flux s'arrête ici.
Contact visible : nouvelle entrée de chat ; sinon : logs Gateway et version plugin.
Aller-retour echo : message court, réponse dans le SLA (secondes à quelques minutes selon le backend).
Test redémarrage : openclaw gateway restart, renvoyer un message — la session devrait tenir (soft restart).
| Aspect | WeChat ClawBot | Telegram (référence) |
|---|---|---|
| Liaison | QR + plugin gris | Token BotFather, pas de QR |
| Type de chat | Principalement privé | Groupes et canaux courants |
| Fichiers | Limites produit à respecter | API Bot plus souple |
| Callback | Gateway 24/7 + ports joignables | Même exigence Gateway |
| Conformité | Règles WeChat, RGPD pour utilisateurs UE | Autres profils de données |
| Symptôme | Vérifier d'abord | Action typique |
|---|---|---|
| QR expiré | Fenêtre temps, terminal fermé | Nouveau QR ; screen pour session distante |
| Pas de message entrant | Gateway down, pare-feu, version plugin | openclaw gateway status ; logs phase plugin |
| Silence après restart | Persistance session, déploiement dur | Séparer soft restart et rebuild image ; re-liaison si besoin |
| Erreur npm / npx | Miroir, proxy, version Node | Changer registry ; chemin plugin manuel |
| Chat de groupe voulu | Périmètre produit 2026 | Non supporté — adapter l'architecture ou un autre canal |
Attention : ne pas mélanger dans un même ticket re-liaison WeChat, changement de backend modèle et webhook Telegram — bisection impossible.
WeChat ClawBot en production signifie Gateway et plugin sur hôte ou conteneur isolé, monitoring de latence canal, runbook de re-liaison après déploiement. Lisez les logs en trois phases — plugin (liaison, QR), Gateway (routage, heartbeat), backend modèle (timeout, contexte) — au lieu d'étiqueter « WeChat cassé ».
Les Gateways sur portable échouent à la veille et au NAT ; les canaux IM exigent la même discipline 24/7 que Telegram. Pour capacité dédiée, callbacks stables et changements auditables, la location cloud Mac Mini VpsMesh co-localise canaux WeChat et Telegram avec le durcissement multi-canal. Tarifs, Centre d'aide, Commander.
Oui. Les deux canaux partagent le même Gateway OpenClaw ; skills et routage modèle sont communs. Il faut un Gateway 24/7 et des callbacks joignables — voir durcissement multi-canal.
Typiquement : QR expiré, Gateway offline au scan, pas de plugin gris, ou pare-feu d'entreprise. Regénérez le QR, vérifiez openclaw gateway status et l'accès gris — ne changez pas d'abord le backend modèle.
Un soft restart devrait conserver la session WeChat ; après rebuild d'image ou upgrade plugin, une re-liaison peut être nécessaire. Logs en trois phases ; pour un service durable, migrer vers un Mac distant — guide 24/7, tarifs.