OpenClaw sur WeChat

OpenClaw se connecte à WeChat par une extension de canal externe maintenue par l’équipe Weixin de Tencent, et la documentation est précise sur ce que cela veut dire : le code WeChat ne vit pas dans le dépôt du cœur d’OpenClaw, OpenClaw fournit le contrat générique d’extension de canal, et l’extension fournit l’environnement propre à WeChat. Les discussions directes et les médias sont pris en charge ; les discussions de groupe ne sont pas annoncées, puisque l’extension ne déclare que les discussions directes. Voici comment elle tourne, la connexion, la faille de contrôle d’accès que la documentation signale pour la version actuelle, le tableau de compatibilité, et les correctifs.

Comment elle tourne

• Le nommage d’abord : WeChat est le nom côté utilisateur, Weixin est le nom dans le paquet et l’identifiant d’extension de Tencent, et l’identifiant de canal OpenClaw est openclaw-weixin, avec weixin et wechat comme alias.
• Installez le paquet avec l’installeur rapide ou avec les commandes d’installation et d’activation d’extension ; les commandes d’extension s’appliquent à une passerelle en marche, donc démarrez-la si elle est arrêtée.
• La passerelle découvre le manifeste de l’extension, charge son point d’entrée, et l’extension enregistre le canal ; la connexion par QR sur la machine même qui fait tourner la passerelle enregistre le jeton du compte localement, et l’extension lance un moniteur pour chaque compte configuré au démarrage de la passerelle.
• Les messages entrants sont normalisés par le contrat de canal, routés vers l’agent choisi, et renvoyés par le chemin sortant de l’extension ; la connexion, les appels à l’API iLink de Tencent, les médias, les jetons de contexte et la surveillance des comptes appartiennent tous à l’extension.

Ne comptez pas sur l’appairage standard pour gérer ou révoquer l’accès aux messages directs avec la version 2.4.8.

La faille de contrôle d’accès

La version 2.4.8 n’enregistre pas d’adaptateur d’appairage OpenClaw et ne crée pas de demandes d’appairage, si bien que les commandes standard de liste et d’approbation ne peuvent pas établir l’accès aux messages directs ; la connexion par QR peut toujours autoriser l’utilisateur qui a scanné le code. Au lieu du magasin d’appairage SQLite d’OpenClaw, cette version lit un ancien fichier JSON de liste d’autorisation, retombe sur l’identifiant d’utilisateur enregistré par le scanner de QR quand cette liste est vide, et si aucun des deux ne fournit d’identifiant, admet tout expéditeur dont le message atteint l’extension. Sur l’OpenClaw actuel, la migration au démarrage et la correction du docteur importent les anciennes approbations dans SQLite et suppriment le fichier source, si bien que des expéditeurs secondaires déjà approuvés peuvent perdre l’accès, et révoquer une approbation dans SQLite ne révoque pas un accès accordé par le fichier de l’extension ou le repli du scanner. Le conseil de la documentation est de désactiver temporairement l’extension si vous avez besoin d’un appairage appliqué, jusqu’à une version dont l’appairage est réparé.

Compatibilité et processus annexe

• La version 2.4.8 déclare OpenClaw 2026.5.12 ou plus récent sous l’étiquette latest, et la lignée 1.x déclare de 2026.1.0 à 2026.3.22 sous l’étiquette legacy ; le garde de démarrage de la 2.4.8 ne vérifie encore que 2026.3.22, et passer ce garde seul ne satisfait pas l’exigence déclarée.
• L’extension 2.4.6 importe un chemin de SDK retiré et ne peut pas se charger sur OpenClaw 2026.8.1 ; si le démarrage signale que ce sous-chemin n’est pas exporté, passez à la 2.4.8. Pour plusieurs comptes, relancez la connexion et isolez les sessions de messages directs par compte, canal et correspondant.
• L’extension peut exécuter un travail auxiliaire à côté de la passerelle ; ce chemin a un jour exposé un bogue dans le nettoyage générique des passerelles obsolètes, où un processus enfant tentait de nettoyer son parent et provoquait des boucles de redémarrage sous systemd. Le nettoyage au démarrage actuel exclut le processus courant et ses ancêtres, un correctif générique plutôt que propre à WeChat.

L’appairage dans OpenClaw est le flux d’approbation que cette version ne peut pas encore utiliser, et Les extensions d’OpenClaw explique comment des extensions externes comme celle-ci se chargent à côté de la passerelle.

Dépannage

Vérifiez la liste des extensions, la sonde de canal et la version d’OpenClaw. Si le canal apparaît installé mais ne se connecte pas, activez-le et inspectez l’extension en marche avec son rapport d’exécution. Si la passerelle redémarre sans cesse après l’activation de WeChat, mettez à jour OpenClaw et l’extension, en forçant la réinstallation, puis redémarrez la passerelle. Si le démarrage dit que le paquet exige une sortie d’exécution compilée pour une entrée TypeScript, le paquet npm a été publié sans le JavaScript compilé ; attendez un paquet corrigé, ou désactivez l’extension entre-temps.

Sur Diali

WeChat ne fait pas partie des canaux que Diali connecte aujourd’hui : ceux que nous faisons tourner sont WhatsApp, Telegram, Discord, Slack, Mattermost, Matrix, SMS et la voix, et une instance autogérée est là où vit cette extension pour l’instant. Connecter votre premier canal en cinq minutes montre notre flux de connexion, OpenClaw hébergé sur Diali est l’assistant et La sécurité chez Diali décrit la frontière.

• Une extension externe, donc le cœur reste agnostique aux canaux.
• Connexion par QR sur la machine de la passerelle, un jeton par compte.
• L’appairage ne peut pas gouverner la version 2.4.8 ; désactivez-la s’il vous faut une application stricte.