OpenClaw est longtemps passé par Telegram, Discord et Slack ; en Chine, les équipes utilisaient Wechaty, protocoles iPad ou webhooks non officiels. Problèmes communs : protocoles qui cassent sans préavis, risque de suspension de compte, maintenance portée par un seul développeur. Fin mars 2026, Tencent publie le plugin « WeChat ClawBot » et le scope npm @tencent-weixin/openclaw-weixin-cli — lier par QR un OpenClaw Gateway en cours d'exécution devient un flux produit standard.

ClawBot n'est pas un LLM intégré à WeChat : il connecte votre Agent OpenClaw configuré (persona, MEMORY, Skills, routage modèle) à une fenêtre de chat dans vos contacts. Les messages transitent par l'application WeChat ; l'inférence et les outils restent sur votre hôte Gateway. Tencent modère le contenu, sans héberger votre modèle. En incident, séparez canal WeChat, Gateway et API modèle — ne tout attribuer à « WeChat en panne ».

Sans daemon Gateway observable, terminez d'abord install-daemon, puis ClawBot — sinon le premier message après scan reste bloqué sur « Gateway n'écoute pas ». Documentez versions plugin, paquet CLI et openclaw dans le ticket de changement.

Les équipes distribuées doivent décider tôt quelles métadonnées de chat peuvent apparaître dans les journaux Gateway. ClawBot transite par l'infrastructure Tencent ; l'inférence reste sur votre hôte, mais finalité et rétention des logs doivent être documentées. Surveillez les changements d'état Gateway plutôt que chaque accusé WeChat.

Environ la moitié des échecs ClawBot vient d'une application WeChat trop ancienne, l'autre moitié d'un Gateway pas réellement ready. Le tableau regroupe les champs pour l'astreinte. Vérifiez aussi bande passante sortante et latence npm registry — un timeout npx ressemble à une panne plugin.

Sur Mac cloud KVMNODE dédié : répertoire d'état hors iCloud ou sync d'équipe, sinon échecs d'écriture intermittents simulent des déconnexions ClawBot aléatoires. Tokens : token launchd et échelle L2 — ne réinstallez pas WeChat en premier. Si la clé modèle est en variable d'environnement, alignez EnvironmentVariables plist et shell SSH.

export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"
openclaw gateway status --deep
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
openclaw gateway restart
openclaw channels probe 2>/dev/null || true

La liaison s'exécute sur l'hôte qui fait réellement tourner Gateway. OpenClaw sur un nœud KVMNODE à Singapour et npx sur le portable local pointent le QR vers la mauvaise instance. SSH sur le Mac cloud ou ssh user@host 'npx ...'. Joignez lignes de log Gateway et timestamp du premier message WeChat pour séparer latence canal et latence modèle.

Pendant la semaine d'acceptation, répétez les étapes 05 et 06 après chaque openclaw gateway restart et après upgrade Node. Les régressions apparaissent avant que les utilisateurs ne rescanent. Si channels probe n'est pas encore câblé pour WeChat, un aller-retour manuel plus une ligne de gateway status --deep suffit — seulement si health était verte au préalable.

Documentation et retours terrain : ClawBot vise le chat privé, pas un bot @ dans un groupe WeChat avec le même plugin. L'entrée utilise resolveAgentRoute par channel + accountId + peer — contexte distinct par paire ; changer souvent d'Agent dans le même fil perturbe la machine d'état.

Bots de groupe, messages d'application et API documents relèvent du plugin OpenClaw WeCom officiel, pas du ClawBot personnel. Les deux canaux peuvent coexister sur un Gateway — routing explicite dans openclaw.json. Limitez les Skills à sorties sensibles sur le canal WeChat si la modération bloque.

Pour un assistant interne avec MEMORY métier, listez les outils autorisés sur le canal WeChat. Un Skill exportant des fichiers du workspace peut déclencher la modération alors que Gateway et modèle sont sains. Testez des prompts de production, pas seulement « bonjour », en acceptation.

QR expiré : valable quelques minutes — relancer npx, pas de capture réutilisée.Règle 24 h : inactivité longue peut rejeter les push proactifs — Q&R, pas campagne marketing.Modération : WeChat bloque en cas de non-conformité — ajuster prompts et sorties outils dans OpenClaw, pas rebinder en boucle.Veille Gateway : portable fermé coupe ClawBot comme Telegram — plus visible car WeChat est l'entrée quotidienne.

Triage : gateway status --deep → API modèle → npx install rescan → journaux Gateway → réinstall WeChat en dernier. channels 401 ou split brain : alignement CLI d'abord. Séparez dans le ticket « échec envoi WeChat » et « Gateway ne répond pas ».

Si le même Mac cloud héberge CI iOS et OpenClaw, 16 Go de mémoire unifiée sous xcodebuild et Gateway peut ralentir les réponses WeChat sans couper le canal — M4 Pro ou split de pool plutôt que rescans répétés. Consultez isolation same-pool avant de changer de palier.

Un portable en veille est une mauvaise référence pour « ça marchait chez moi ». Les Mac cloud dédiés offrent des fenêtres launchd stables. Choisissez la région selon Git et sortie modèle, pas WeChat seul — le canal est côté client en Chine, Gateway reste sur votre nœud. Pour une entrée WeChat auditable 7×24 avec Gateway sur le même hôte, la location Mac mini KVMNODE reste le choix habituel : six régions, hôte dédié, location jour à mois, un runbook pour 18789 et launchd. Tarifs : page tarifs, guides : centre d'aide, commande : commander.