@tencent-weixin/openclaw-weixin) permet à OpenClaw en 2026 d'accéder à WeChat en chat privé conforme, sans passer par des ponts iPad non autorisés. Les équipes qui négligent la matrice de versions, la gradation client et l'hôte Gateway observent souvent : scan QR réussi, Control UI indiquant le canal connecté, mais aucune réponse Agent en conversation réelle — ou, après une mise à jour mineure d'OpenClaw, une dérive ABI du plugin et des pertes silencieuses. Ce guide fournit un chemin exécutable : installation openclaw-weixin-cli en un clic, pinning 1.0.x/2.0.x face à OpenClaw 2026.3.x, client WeChat 8.0.70+, et la répartition Gateway 7×24 sur Mac cloud, poste local réservé à la console et au scan.
Cinq erreurs de lecture les plus fréquentes à l'intégration WeChat ClawBot
Le parcours d'intégration WeChat ClawBot en 2026 croise trois axes : hôte Gateway macOS, version noyau OpenClaw et gradation client WeChat. Une exploitation qui confond « QR réussi » et « prêt pour la production » ignore chat privé uniquement, fichiers entrants seulement et le fait que les messages actifs après 24 heures sans interaction peuvent être abandonnés. Plus discret : la dérive de version du plugin par rapport au noyau OpenClaw — 1.0.x pour >=2026.3.0 et <2026.3.22, 2.0.x à partir de >=2026.3.22. Un upgrade au-delà de la frontière sans gateway restart laisse parfois doctor au vert. Classez d'abord les tickets par signature avant de modifier le routage modèle, de changer de compte secondaire ou de migrer le Gateway vers un Mac cloud sans veille.
Pour les équipes européennes, le traitement des contenus sur des serveurs en Chine relève du droit local et des politiques Tencent ; documentez la finalité, la durée de conservation et les mesures contractuelles avant d'exposer des utilisateurs finaux au bot. Ne transmettez jamais de données personnelles sensibles via WeChat si votre registre de traitements ne couvre pas ce flux transfrontalier.
Assimiler un pont protocole iPad tiers au ClawBot officiel : les ponts non autorisés exposent au blocage de compte et aux changements de protocole ; le plugin officiel emprunte des API régulées avec des limites différentes (chat privé, sens des fichiers, filtrage). Les anciens runbooks ne s'appliquent pas.
Scanner sans vérifier la version client WeChat : iOS requiert 8.0.70+ en déploiement général ; Android 8.0.69+ encore en gradation. Des clients obsolètes produisent des états de connexion erratiques ou une désynchronisation des messages.
Ne pas aligner la version majeure openclaw-weixin après upgrade OpenClaw : 2026.3.22 est la ligne de partage. Rester en 1.0.x sur un noyau plus récent simule une connexion saine. Vérifier openclaw --version et la matrice.
Attendre des réponses en groupe ou en contexte entreprise : aujourd'hui chat privé seulement. L'absence de réponse aux @ en groupe est une limite produit, pas une panne Gateway.
Utiliser le compte principal en production et y coller des fragments de clés : les données transitent par des serveurs en Chine avec filtrage de contenu. Compte secondaire obligatoire ; pas de clés API, adresses internes ou données clients dans le chat.
Une fois les signatures étiquetées, ajustez routage et politiques canal. Si le Gateway n'a jamais été validé sur un hôte cloud, suivez le guide d'installation OpenClaw sur Mac cloud et workflow Lobster pour install.sh et LaunchAgent. Canal connecté mais muet : lisez en parallèle canal connecté sans réponse pour séparer couche processus et couche politique, plutôt que de rescanner WeChat en boucle.
Pont tiers, ClawBot officiel et Gateway Mac cloud : matrice en trois voies
En 2026, la communauté propose encore plusieurs branchements WeChat ; le choix production doit comparer conformité, limites fonctionnelles et disponibilité 7×24 dans un même tableau. Le ClawBot officiel convient aux équipes exigeant l'aval Tencent et acceptant chat privé plus modération ; les ponts tiers offrent parfois groupes ou envoi de fichiers, au prix de risques protocole et compte. Quel que soit le chemin message, la face de contrôle Gateway doit résider sur un Mac cloud sans veille ; le portable ne sert qu'au QR et à la Control UI.
| Dimension | Pont protocole tiers | openclaw-weixin officiel | Gateway Mac cloud + plugin officiel |
|---|---|---|---|
| Conformité et risque compte | Élevé, contrôle plateforme | Plugin Tencent, compte secondaire | Comme officiel, hôte plus stable |
| Forme de session | Souvent groupes selon implémentation | Chat privé uniquement | Chat privé, en ligne 7×24 |
| Fichiers | Souvent bidirectionnel | Entrants seulement | Comme officiel |
| Installation | Hétérogène | npx @tencent-weixin/openclaw-weixin-cli | CLI + LaunchAgent sur Mac cloud |
| Couplage version | Faible avec OpenClaw | Matrice 1.0.x / 2.0.x | Pinning synchronisé avec Master |
| Traitement des données | Souvent opaque | Serveurs Chine, filtrage | Idem ; logs Gateway locaux minimisés |
| Recommandé 2026 | Non en production | Assistant chat privé conforme | Équipes distribuées, automatisation |
Messages via ClawBot officiel ; contrôle via loopback Mac cloud. Ne pariez pas sur la veille du portable pour WeChat 7×24.
Après choix du plugin officiel, documentez : quel Mac cloud porte le Gateway, qui détient le compte secondaire, versions pinnées OpenClaw et openclaw-weixin. En phase d'essai, un Mac local peut temporairement héberger le Gateway — ne liez pas le même jeton canal en parallèle sur le Master, sous peine de double consommation. Windows en Node seul : répartition Windows/WSL2 et Mac cloud. Versionnez les changements de configuration dans le dépôt Git de l'équipe pour des rollbacks traçables.
openclaw-weixin-cli, chaîne plugin manuelle et matrice de compatibilité
Point d'entrée recommandé : le wrapper CLI Tencent, qui récupère la version compatible de @tencent-weixin/openclaw-weixin sur un hôte OpenClaw et écrit la configuration. Pour CI ou fenêtre de maintenance, enchaînement manuel : install → enable → channels login → gateway restart. Prérequis OpenClaw >=2026.3.0 ; version majeure plugin : 1.0.x si OpenClaw >=2026.3.0 et <2026.3.22, 2.0.x si >=2026.3.22. Côté WeChat : iOS 8.0.70+ ou Android 8.0.69+ (gradation), scan avec compte secondaire.
npx -y @tencent-weixin/openclaw-weixin-cli@latest install openclaw plugins install "@tencent-weixin/openclaw-weixin" openclaw config enable channels.openclaw-weixin openclaw channels login --channel openclaw-weixin openclaw gateway restart openclaw channels probe --channel openclaw-weixin openclaw doctor
@latest tente d'aligner la version OpenClaw ; si vous avez pinné un build 2026.3.x, archivez la sortie de openclaw plugins list après installation. Scan QR sur l'hôte Gateway ou Control UI accessible de façon sécurisée ; envoyez ensuite un message test depuis le compte secondaire pour valider inbound vers l'Agent et outbound visible en chat privé. Échec de probe : openclaw gateway status, openclaw logs, vérifier si la version majeure du plugin a franchi la frontière.
Limites produit : chat privé seulement ; fichiers réception uniquement ; après 24 h sans interaction, messages actifs parfois abandonnés. Traitement sur serveurs en Chine avec filtrage — pas de clés ni de données clients. Conservez les logs Gateway avec parcimonie.
Runbook en six étapes : du pinning de version au smoke test chat privé
Geler le triplet de versions : OpenClaw, openclaw-weixin 1.0.x ou 2.0.x, client WeChat (iOS 8.0.70+ / Android 8.0.69+ gradation), responsable du compte secondaire.
Master Gateway sur Mac cloud : parcours Lobster — install.sh, onboard, LaunchAgent ; loopback 18789 et gateway status au vert.
Plugin officiel : de préférence npx -y @tencent-weixin/openclaw-weixin-cli@latest install ; fenêtre de maintenance : chaîne plugins install manuelle avec sortie archivée.
QR channels login : openclaw channels login --channel openclaw-weixin sur hôte Gateway ou Control UI sécurisée, autoriser le compte secondaire.
restart et probe : openclaw gateway restart, puis channels probe et doctor. Node Windows : remote pointe vers Master, pas de second Gateway local.
Smoke chat privé : texte et fichier entrant depuis le compte secondaire ; réponse Agent sans fichier sortant ; mettre le portable en veille — le canal ne dépend que du Mac cloud.
Inscrivez les trois limites produit — chat privé, pas de fichiers sortants, silence 24 h — dans le manuel d'astreinte. Telegram, Discord, etc. en parallèle : jetons et sections config séparés pour éviter les conflits de fusion. Committez les changements de branche config OpenClaw dans le dépôt Git pour des retours arrière auditables après upgrade plugin.
Trois seuils d'astreinte et choix du Gateway Mac cloud en six régions
Ligne rouge alignement version : OpenClaw passé au-delà de 2026.3.22, openclaw-weixin encore en 1.0.x, probe intermittente rouge → mismatch ABI : passer en 2.0.x, restart, puis seulement routage modèle.
Plancher gradation client : iOS sous 8.0.70 ou Android sans gradation 8.0.69+ → pas de compte secondaire en production. Ticket avec capture « À propos de WeChat » et horodatage du scan.
Acceptation split : après restauration Master, au moins 3× channels probe en 10 minutes ; après reboot hôte, réponse Agent en chat privé en 60 s, sans portable développeur en ligne.
Attention : seuils = communication opérationnelle, pas SLA Tencent ou OpenClaw. Filtrage et règles 24 h suivent la plateforme WeChat du moment.
Attacher le Gateway WeChat ClawBot à un Mac personnel ou un portable Windows réintroduit veille, redémarrages de mise à jour et itinérance Wi-Fi. Un VPS Linux pur exécute OpenClaw mais perd la proximité toolchain macOS pour certains plugins canal. Mac cloud Master pour openclaw-weixin et garde 7×24 équilibre chat privé conforme, discipline loopback et fenêtres de location prévisibles. Pour un Agent WeChat stable sans parier sur du matériel grand public : location Mac mini cloud MESHLAUNCH — région cible en location journalière, six étapes plus reboot hôte, puis mensuel. Capacité : tarifs et centre d'aide.
OpenClaw >=2026.3.0 et <2026.3.22 → 1.0.x ; >=2026.3.22 → 2.0.x. Après upgrade : gateway restart et channels probe. Première install : guide Lobster ; location : tarifs.
Statut Gateway et probe d'abord ; puis erreur de groupe, filtrage, inactivité 24 h. Couches : canal silencieux ; support : centre d'aide.
Non recommandé. Webhooks production sur Master Mac cloud ; Windows en Node ou console seulement. Runbook split Windows/WSL2.
Chat privé uniquement ; fichiers entrants seulement ; traitement en Chine avec filtrage. Compte secondaire, pas de clés. Mac cloud 7×24 : tarifs.