Passer au contenu principal

​
WeChat

OpenClaw se connecte à WeChat via le Plugin de canal externe @tencent-weixin/openclaw-weixin. Statut : Plugin externe. Les discussions directes et les médias sont pris en charge. Les discussions de groupe ne sont pas annoncées par les métadonnées de capacité du Plugin actuel.

​
Dénomination

  • WeChat est le nom affiché à l’utilisateur dans cette documentation.
  • Weixin est le nom utilisé par le package de Tencent et par l’identifiant du Plugin.
  • openclaw-weixin est l’identifiant du canal OpenClaw.
  • @tencent-weixin/openclaw-weixin est le package npm.
Utilisez openclaw-weixin dans les commandes CLI et les chemins de configuration.

​
Fonctionnement

Le code WeChat ne se trouve pas dans le dépôt core d’OpenClaw. OpenClaw fournit le contrat générique de Plugin de canal, et le Plugin externe fournit le runtime spécifique à WeChat :
  1. openclaw plugins install installe @tencent-weixin/openclaw-weixin.
  2. Le Gateway détecte le manifeste du Plugin et charge le point d’entrée du Plugin.
  3. Le Plugin enregistre l’identifiant de canal openclaw-weixin.
  4. openclaw channels login --channel openclaw-weixin lance la connexion par QR code.
  5. Le Plugin stocke les identifiants du compte dans le répertoire d’état d’OpenClaw.
  6. Lorsque le Gateway démarre, le Plugin lance son moniteur Weixin pour chaque compte configuré.
  7. Les messages entrants de WeChat sont normalisés via le contrat de canal, routés vers l’agent OpenClaw sélectionné, puis renvoyés via le chemin sortant du Plugin.
Cette séparation est importante : le core d’OpenClaw doit rester indépendant des canaux. La connexion WeChat, les appels à l’API Tencent iLink, le téléversement/téléchargement des médias, les jetons de contexte et la surveillance des comptes relèvent du Plugin externe.

​
Installation

Installation rapide : 
npx -y @tencent-weixin/openclaw-weixin-cli install
Installation manuelle : 
openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true
Redémarrez le Gateway après l’installation : 
openclaw gateway restart

​
Connexion

Lancez la connexion par QR code sur la même machine que celle qui exécute le Gateway : 
openclaw channels login --channel openclaw-weixin
Scannez le QR code avec WeChat sur votre téléphone et confirmez la connexion. Le Plugin enregistre le jeton du compte localement après un scan réussi. Pour ajouter un autre compte WeChat, exécutez à nouveau la même commande de connexion. Pour plusieurs comptes, isolez les sessions de messages directs par compte, canal et expéditeur : 
openclaw config set session.dmScope per-account-channel-peer

​
Contrôle d’accès

Les messages directs utilisent le modèle normal d’appairage et de liste d’autorisation d’OpenClaw pour les Plugins de canal. Approuvez les nouveaux expéditeurs : 
openclaw pairing list openclaw-weixin
openclaw pairing approve openclaw-weixin <CODE>
Pour le modèle complet de contrôle d’accès, consultez Appairage.

​
Compatibilité

Le Plugin vérifie la version d’OpenClaw hôte au démarrage.
Ligne du PluginVersion d’OpenClawTag npm
2.x>=2026.3.22latest
1.x>=2026.1.0 <2026.3.22legacy
Si le Plugin indique que votre version d’OpenClaw est trop ancienne, mettez soit OpenClaw à jour, soit installez la ligne legacy du Plugin : 
openclaw plugins install @tencent-weixin/openclaw-weixin@legacy

​
Processus sidecar

Le Plugin WeChat peut exécuter un travail auxiliaire à côté du Gateway pendant qu’il surveille l’API Tencent iLink. Dans l’issue #68451, ce chemin auxiliaire a révélé un bug dans le nettoyage générique des Gateway obsolètes d’OpenClaw : un processus enfant pouvait essayer de nettoyer le processus Gateway parent, provoquant des boucles de redémarrage sous des gestionnaires de processus comme systemd. Le nettoyage actuel au démarrage d’OpenClaw exclut le processus en cours et ses ancêtres, donc un processus auxiliaire de canal ne doit pas tuer le Gateway qui l’a lancé. Cette correction est générique ; ce n’est pas un chemin spécifique à WeChat dans le core.

​
Dépannage

Vérifiez l’installation et l’état : 
openclaw plugins list
openclaw channels status --probe
openclaw --version
Si le canal apparaît comme installé mais ne se connecte pas, confirmez que le Plugin est activé puis redémarrez : 
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw gateway restart
Si le Gateway redémarre en boucle après l’activation de WeChat, mettez à jour OpenClaw et le Plugin : 
npm view @tencent-weixin/openclaw-weixin version
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
openclaw gateway restart
Désactivation temporaire : 
openclaw config set plugins.entries.openclaw-weixin.enabled false
openclaw gateway restart

​
Documentation connexe