Vous souhaitez piloter votre agent OpenClaw depuis WeChat personnel, sans clarifier l’ordre entre le plugin ClawBot et le Gateway. Ce guide s’adresse aux opérateurs qui exécutent ou préparent OpenClaw en 2026 avec le canal officiel Tencent openclaw-weixin : contrôles préalables, npx @tencent-weixin/openclaw-weixin-cli install face aux étapes manuelles, matrice 2.0.x / legacy, dmScope multi-comptes et limites WeChat (chat seul, fichiers entrants uniquement, 8.0.70+, revue de contenu). Il complète la triade Telegram post-déploiement, la sonde channels et la reprise demi-installation.
Le WeChat ClawBot 2026 (Réglages → Extensions) est l’entrée canal officielle. Les compétences et les appels modèle s’exécutent sur votre OpenClaw Gateway. OpenClaw est le « homard » ; ClawBot est la ligne téléphonique — sans elle, un Gateway sain ne reçoit pas le trafic WeChat.
Plugin WeChat seul, sans OpenClaw : la connexion QR peut réussir, aucun agent ne traite l’entrant.
Hôte trop ancien : le plugin 2.0.x exige >=2026.3.22 ; refus au démarrage avec requires OpenClaw >=2026.3.22.
Gateway non permanent : veille du portable, Docker sans redémarrage, VPS sans systemd — hier opérationnel, aujourd’hui muet.
Confondre ClawBot et Tencent Yuanbao : Yuanbao est un produit Tencent ; ClawBot relie votre OpenClaw — vous portez l’exploitation.
Plusieurs comptes WeChat, un seul compartiment de session : sans session.dmScope, les réponses peuvent se croiser.
Ignorer les limites produit WeChat : canal officiel en chat seul, sans groupes — section 4.
| Dimension | Plugin ClawBot officiel | App WeCom auto-hébergée | Bot Telegram (OpenClaw intégré) |
|---|---|---|---|
| Public | Essais personnels, automatisation en chat seul | Équipes, groupes, conformité | Communauté internationale, gating de groupe mature |
| Effort d’installation | Faible : openclaw-weixin-cli + QR | Élevé : IP publique, callback, IP de confiance | Moyen : jeton bot + pairing |
| Version WeChat | 8.0.70+ (entrée plugin) | Scan compte entreprise | N/A |
| Chat de groupe | Non pris en charge | Extensible | Pris en charge (politiques de mention) |
| Article de dépannage | Cet article | Documentation plugin WeCom | Triade post-déploiement |
« Envoyer depuis WeChat » n’équivaut pas à « canal bouclé » — plugin activé, redémarrage Gateway et sonde réussie restent trois portes distinctes.
Validez d’abord la baseline OpenClaw et Node (déploiement production Node 24). Gateway absent : lisez la reprise demi-installation avant un nouveau scan QR.
Version hôte : openclaw --version ; sous 2026.3.22 pour 2.0.x : openclaw update ou ligne legacy (section 4).
Installation en une commande : npx -y @tencent-weixin/openclaw-weixin-cli install — détection de version, plugins install, QR, redémarrage Gateway.
Équivalent manuel : openclaw plugins install "@tencent-weixin/openclaw-weixin" → openclaw config set plugins.entries.openclaw-weixin.enabled true → openclaw channels login --channel openclaw-weixin → openclaw gateway restart.
Client WeChat : 8.0.70+, Moi → Réglages → Extensions → « WeChat ClawBot » ; sur Android sans déploiement progressif, le QR CLI peut forcer la mise à jour du plugin.
Multi-comptes (optionnel) : répéter channels login ; openclaw config set session.dmScope per-account-channel-peer ; channels.openclaw-weixin.botAgent optionnel pour les logs uniquement.
Acceptation : openclaw channels status --probe + openclaw doctor --deep ; message test dans WeChat et openclaw logs --follow. Pairing : article channels probe.
# Canal Tencent WeChat 2026 — une commande + acceptation npx -y @tencent-weixin/openclaw-weixin-cli install openclaw --version openclaw channels status --probe openclaw doctor --deep openclaw logs --follow # Hôte ancien : ligne de plugin legacy openclaw plugins install @tencent-weixin/openclaw-weixin@legacy
Conseil : si npx est lent, pointez npm vers un miroir puis réessayez. En échec d’installation plugin, vérifiez openclaw plugins list avant un nouveau scan QR.
Attention : le trafic passe par le canal officiel Tencent avec revue de contenu. Préférez un compte WeChat secondaire pour la production.
| Ligne plugin | Hôte OpenClaw | dist-tag npm | Erreur typique |
|---|---|---|---|
| 2.0.x | >= 2026.3.22 | latest | Hôte trop ancien → mettre à jour OpenClaw |
| 1.0.x | >= 2026.1.0 < 2026.3.22 | legacy | Installer @legacy plutôt que forcer l’hôte |
Un portable en veille coupe WeChat dès la fermeture du capot. Un nœud macOS exclusif et toujours actif correspond mieux à un canal 7×24, supervisé comme dans les contrôles launchd sur Mac distant.
Pour une provisionnement de type VPS sur Mac maintenables en SSH, avec ce runbook intégré à l’image, la location Mac Mini cloud NodeMini est en général plus adaptée qu’un Gateway domestique intermittent. Consultez les tarifs de location et le centre d’aide.
ClawBot est le plugin canal ; OpenClaw Gateway est le runtime. Installez OpenClaw d’abord, puis openclaw-weixin-cli. Base : dépannage installation multiplateforme.
Définissez plugins.entries.openclaw-weixin.enabled à true et gateway restart. Multi-comptes : session.dmScope per-account-channel-peer. Dimensionnement : tarifs location Mac Mini.
L’article Telegram traite 409, webhooks et Chrome Relay. Celui-ci couvre le plugin WeChat officiel Tencent et les limites produit. Aide : centre d’aide.