2026 Tencent WeChat ClawBot avec OpenClaw : installation, compatibilité et runbook Mac VPS (matrice décision et FAQ)
Le plugin officiel Tencent @tencent-weixin/openclaw-weixin permet d'utiliser WeChat personnel comme entrée IM pour OpenClaw — à condition que votre client affiche ClawBot dans Réglages → Plugins (iOS 8.0.70+, Android 8.0.69+ en déploiement graduel). Scanner le QR avant d'avoir une passerelle stable produit des timeouts et un « canal connecté sans réponse ». Ce guide suit l'ordre recommandé : auto-contrôle graduel → preflight Mac VPS → npx -y @tencent-weixin/openclaw-weixin-cli install → liaison → acceptation — avec matrice WeCom/Telegram, tableau 2.0.x/1.0.x, limites produit, runbook sept étapes et triage par couche.
Sommaire
- 1. Points de friction : pas de ClawBot, version, QR et déconnexion
- 2. Matrice : WeChat personnel vs WeCom vs Feishu vs Telegram
- 3. Auto-contrôle déploiement graduel sur mobile
- 4. Preflight Mac VPS : Node 22, 18789, provider, launchd
- 5. Compatibilité : openclaw-weixin 2.0.x vs 1.0.x
- 6. Limites et conformité
- 7. Runbook sept étapes : base → CLI → QR → 7j/7
- 8. Mapping erreurs et triage
- 9. Exemples métier
- 10. FAQ
- 11. Conclusion
1. Points de friction : pas de ClawBot, version, QR et déconnexion
WeChat personnel diffère fondamentalement de WeChat Entreprise (WeCom) : Tencent contrôle le déploiement graduel, la version protocole et la sortie des données. Quatre schémas dominent les tickets support au printemps 2026.
- Pas d'entrée ClawBot : client hors zone graduelle — pas de menu plugin, CLI installée mais pas de QR. Attendre ou tester un appareil plus récent ; ne pas modifier la passerelle.
- Plugin refuse de charger : OpenClaw sous 2026.3.22 ou mauvaise ligne major openclaw-weixin ; les logs montrent un mismatch de version, pas une erreur réseau.
- Échec scan QR : passerelle absente sur 18789, pare-feu, ou smoke de base jamais vert — le téléphone n'atteint pas le VPS.
- Réception seule, pas d'envoi : session stale après veille, 429 provider ou dérive de routage ; souvent confondu avec un bot cassé alors que canal connecté sans réponse est la vraie couche.
Ne changez qu'une chose par étape lors de la première installation : d'abord passerelle stable, puis plugin, puis QR. Les upgrades parallèles du cœur OpenClaw et du plugin WeChat créent des combinaisons non documentées qui ressemblent à des déconnexions aléatoires.
Dans les post-mortems, les équipes suspectent le réseau ou le LLM alors que JSONL montre déjà un refus de plugin ou un QR expiré. Conservez une seule sessionId pendant le diagnostic et évitez de mélanger rebind QR, rotation de secrets gateway et changement de provider.
2. Matrice : WeChat personnel vs WeCom vs Feishu vs Telegram
ClawBot vise les utilisateurs qui vivent déjà dans WeChat personnel. Les entreprises soumises à la conformité doivent consulter l'intégration WeCom ; multi-canal : runbook Feishu/LINE/Telegram.
| Dimension | WeChat personnel ClawBot | WeCom (entreprise) | Feishu / Telegram |
|---|---|---|---|
| Entrée | App quotidienne, plugin graduel | App admin, API corp | Token bot, webhook |
| Groupes | Non supporté (DM seulement) | Oui, avec politiques IT | Oui, configurable |
| Données | Contenu via serveurs Tencent | Piste audit entreprise | Selon le provider |
| Hôte 7j/7 | Mac VPS + launchd recommandé | Mac VPS courant | Mac VPS ou Docker |
| Conformité | Compte perso, pas de SLA | Validation IT requise | Région/export à vérifier |
La matrice aide à trancher avant d'investir du temps QR : si vous avez besoin de groupes ou d'audit IT, WeCom ou Feishu restent plus adaptés ; ClawBot brille pour l'assistant personnel en DM.
3. Auto-contrôle déploiement graduel sur mobile
Avant d'ouvrir SSH : WeChat → Moi → Réglages → Plugins → ClawBot. Entrée absente = aucun runbook serveur ne suffit. iOS minimum 8.0.70, Android 8.0.69 dans certaines régions. Sans entrée : second appareil à jour, patience sur le rollout, pas de sideload. Avec entrée : preflight passerelle immédiat — la session QR est courte.
Documentez la version exacte du client et la région du compte dans votre ticket de changement. Quand Tencent élargit le graduel, le même VPS peut soudainement afficher un QR valide sans modification — utile pour distinguer régression deploy et simple attente produit.
4. Preflight Mac VPS : Node 22, 18789, provider, launchd
OpenClaw doit tourner en passerelle production avant le plugin Tencent. Suivez le déploiement en cinq étapes et le runbook passerelle.
- Runtime : Node.js 22+ ;
openclaw --versionetopenclaw doctorsans alerte demi-installation. - Passerelle : port 18789 en écoute ;
openclaw gateway statussain. - Provider : au moins un LLM avec echo smoke réussi — sinon WeChat semble muet alors que le canal est vert.
- Même HOME :
UserNamedu plist launchd = utilisateur SSH ; répertoire de travail plugin minimalement privilégié. - Audit : avant skills tiers, audit ClawHub.
openclaw gateway status
openclaw --version
lsof -i :18789
Comparez echo $HOME en shell SSH et via une session simulée launchd. Un écart explique souvent « vert en local, rouge en production » après liaison WeChat.
5. Compatibilité : openclaw-weixin 2.0.x vs 1.0.x
| Ligne plugin | Minimum OpenClaw | Comportement CLI | Note upgrade |
|---|---|---|---|
| 2.0.x (actuel) | ≥ 2026.3.22 | CLI choisit le dist-tag auto | Après upgrade OpenClaw : doctor + rebind si besoin |
| 1.0.x (legacy) | Lignes 2026.2 plus anciennes | Pin manuel requis | Saut vers 2.0.x force souvent nouveau QR |
Après upgrade selon le train de release mai : doctor, vérifier version plugin, répéter smoke DM. « Plugin refused to load » = quasi toujours matrice de versions, pas pare-feu.
6. Limites et conformité
| Règle | Impact | Recommandation |
|---|---|---|
| DM uniquement | Pas de routage groupe | Concevoir les flux support en privé |
| Pas de rich media mixte | Pas de combinaisons image-texte complexes | Privilégier liens et texte brut |
| Inactivité 24 h | Messages proactifs bot parfois rejetés | Tester des tours initiés par l'utilisateur |
| Un WeChat ID par liaison | Pas de split multi-appareil | Compte secondaire pour tests |
| Serveurs Tencent | Contenu quitte le VPS | Pas de secrets dans le chat |
7. Runbook sept étapes : base → CLI → QR → 7j/7
- Valider la base OpenClaw : doctor vert, 18789 en écoute, echo provider — sans WeChat.
- CLI un clic :
npx -y @tencent-weixin/openclaw-weixin-cli install; noter dist-tag et chemin plugin dans les logs. - Secours manuel : si échec CLI,
openclaw plugins install @tencent-weixin/openclaw-weixinouopenclaw channels login weixin. - Scanner QR : ouvrir ClawBot sur le téléphone, scanner le QR terminal ou dashboard — le VPS doit être joignable (Tailscale/VPN si besoin).
- Redémarrer passerelle :
openclaw gateway restartou reload launchctl ;gateway statusà nouveau. - Acceptation DM : envoyer et recevoir en chat privé ; JSONL :
channelIdet Delivery. - Reconnect 7j/7 : simuler redémarrage, écrire après 24 h d'inactivité ; triage ci-dessous si chute.
openclaw gateway restart
openclaw gateway status
openclaw channels status
Archivez horodatage QR et version plugin dans le ticket de changement. Rebind après upgrade major sans trace coûte en général une nouvelle patience graduelle sur mobile.
8. Mapping erreurs et triage
Séquentiel : zone graduelle → version plugin → passerelle → provider → session. Pour « connecté sans réponse », voir article canal ; multi-canal : runbook routage.
| Symptôme | Cause probable | Correctif |
|---|---|---|
| Pas de menu ClawBot | Client hors graduel | Attendre version/région, autre appareil |
| Plugin refused to load | OpenClaw ou plugin trop vieux | Upgrade ≥2026.3.22, relancer CLI |
| Timeout QR | 18789 injoignable | Runbook passerelle, pare-feu, Tailscale |
| Déconnexion après reboot | launchd/HOME incorrect | Plist même compte, rebind |
| Réception seule | Provider ou routage | 429, intents, slice JSONL |
9. Exemples métier
Assistant personnel : développeur lie un WeChat secondaire, demande par DM des métriques serveur — l'agent répond via outils passerelle ; pas besoin de groupes.
WeChat plus Telegram : production sur Mac VPS avec les deux canaux ; test charge deux canaux avant mise en prod pour éviter collision de sessionId.
Micro-entreprise sans WeCom : fondateur solo utilise ClawBot pour DM clients ; communiquer les limites (24 h, pas de rich mix) dans l'accueil.
10. FAQ
Question : Parallèle à Telegram ou Feishu ? Oui — canal séparé ; ne pas sauter l'acceptation multi-canal.
Question : Mac VPS vs Mac local ? 7j/7 et reconnect stable : Mac VPS ; portable en veille casse la liaison.
Question : Rescanner après upgrade ? Souvent non en 2.0.x ; saut depuis 1.0.x ou downgrade OpenClaw souvent oui.
Question : Région étrangère ? Graduel régional ; tester dans la région cible ; éviter contournements App Store douteux.
11. Conclusion
Critère de succès : auto-contrôle graduel → passerelle stable sur 18789 → install CLI → QR → DM reproductible. ClawBot WeChat personnel ne remplace pas WeCom pour la conformité entreprise, mais gagne où les utilisateurs vivent déjà dans WeChat. Pour 7j/7 sans perte de liaison à la veille, choisissez un Mac VPS VPSMAC Apple Silicon avec launchd et même HOME — pas le portable. Suite : passerelle, déploiement, audit skills.