En bref : Connectez OpenClaw à WeChat en installant le plugin @tencent-weixin/openclaw-weixin, en scannant un code QR pour autoriser votre compte et en redémarrant la passerelle. L'installation complète prend moins de 5 minutes. Le plugin est gratuit, open-source et prend en charge plusieurs comptes WeChat simultanément.
Introduction
Exécuter un assistant IA sur WeChat semble compliqué. La plupart des solutions nécessitent des abonnements API coûteux, des configurations de serveur complexes ou des comptes d'entreprise. OpenClaw change cela.
Le plugin @tencent-weixin/openclaw-weixin connecte votre compte WeChat personnel à la passerelle IA d'OpenClaw en quelques minutes. Aucun compte d'entreprise n'est nécessaire. Pas de frais mensuels. Scannez simplement un code QR et vous êtes opérationnel.
Ce guide vous accompagne à travers la configuration complète — de l'installation du plugin à la gestion de plusieurs comptes et à l'isolation des contextes de conversation. À la fin, votre WeChat disposera d'un assistant IA entièrement fonctionnel fonctionnant sur OpenClaw.
Prérequis
Avant de commencer, vous avez besoin :
- OpenClaw installé (version
>=2026.3.22pour le plugin v2.0.x) - L'interface CLI
openclawdisponible dans votre terminal - Un compte WeChat (un compte personnel fonctionne — pas de compte d'entreprise requis)
- Node.js installé (pour l'installateur en un clic)
Vérifiez votre version d'OpenClaw :
openclaw --version
Si vous utilisez une version plus ancienne, mettez à jour d'abord. Le plugin v2.0.x nécessite OpenClaw >=2026.3.22.
Compatibilité du plugin
| Version du plugin | Version d'OpenClaw | Statut |
|---|---|---|
| 2.0.x | >=2026.3.22 |
Actif |
| 1.0.x | >=2026.1.0 <2026.3.22 |
Maintenance |
Le plugin vérifie la version de l'hôte au démarrage. Si votre version d'OpenClaw n'est pas dans la plage requise, le plugin refusera de se charger.
Étape 1 : Installer le plugin
Option A : Installation en un clic (Recommandé)
npx -y @tencent-weixin/openclaw-weixin-cli install
Cela gère tout automatiquement — installation du plugin, configuration et configuration initiale.
Option B : Installation manuelle
Si l'installateur en un clic ne fonctionne pas sur votre système, installez manuellement :
1. Installez le plugin :
openclaw plugins install "@tencent-weixin/openclaw-weixin"
2. Activez le plugin :
openclaw config set plugins.entries.openclaw-weixin.enabled true
Étape 2 : Scanner le code QR pour autoriser WeChat
Une fois le plugin installé, connectez-vous avec votre compte WeChat :
openclaw channels login --channel openclaw-weixin
Un code QR apparaîtra dans votre terminal. Ouvrez WeChat sur votre téléphone, appuyez sur l'icône de scan et scannez le code. Confirmez l'autorisation sur votre téléphone.
Vos informations de connexion sont enregistrées localement automatiquement. Pas besoin de scanner à nouveau, sauf si vous vous déconnectez.
Étape 3 : Redémarrer la passerelle
Après l'autorisation, redémarrez la passerelle OpenClaw pour activer le plugin :
openclaw gateway restart
C'est tout. Votre compte WeChat est maintenant connecté à OpenClaw. Les messages envoyés à votre WeChat seront traités par l'agent IA.
Étape 4 : Ajouter plusieurs comptes WeChat (Facultatif)
OpenClaw prend en charge plusieurs comptes WeChat simultanément. Pour ajouter un autre compte, exécutez simplement la commande de connexion à nouveau :
openclaw channels login --channel openclaw-weixin
Chaque scan de code QR crée une nouvelle entrée de compte. Tous les comptes fonctionnent en parallèle sans interférer les uns avec les autres.
Étape 5 : Isoler les contextes de conversation (Facultatif)
Par défaut, tous les canaux partagent le même contexte de conversation IA. Cela signifie que vos conversations WeChat et d'autres canaux (Telegram, Discord, etc.) partagent la même mémoire IA.
Si vous souhaitez que chaque compte WeChat ait son propre contexte isolé :
openclaw config set agents.mode per-channel-per-peer
Avec ce paramètre, chaque combinaison « compte WeChat + contact » obtient sa propre mémoire IA indépendante. Les conversations entre différents comptes ne se mélangeront pas.
Comment le plugin fonctionne en coulisses
Pour les développeurs qui souhaitent comprendre ou étendre le plugin, voici comment il communique avec la passerelle OpenClaw.
En-têtes d'authentification
Toutes les requêtes API utilisent ces en-têtes :
| En-tête | Valeur |
|---|---|
Content-Type |
application/json |
AuthorizationType |
ilink_bot_token |
Authorization |
Bearer <token> |
X-WECHAT-UIN |
Uint32 aléatoire encodé en base64 |
Points de terminaison API principaux
Le plugin utilise 5 points de terminaison HTTP JSON :
| Point de terminaison | Chemin | Objectif |
|---|---|---|
| getUpdates | getupdates |
Long-polling pour les nouveaux messages |
| sendMessage | sendmessage |
Envoyer texte/image/vidéo/fichier |
| getUploadUrl | getuploadurl |
Obtenir l'URL de téléchargement CDN pour les médias |
| getConfig | getconfig |
Obtenir la configuration du compte (ticket de frappe) |
| sendTyping | sendtyping |
Afficher/masquer l'indicateur de saisie |
Réception des messages (Long Polling)
Le plugin utilise le long polling pour recevoir des messages :
// Requête
{
"get_updates_buf": ""
}
// Réponse
{
"ret": 0,
"msgs": [...],
"get_updates_buf": "<new_cursor>",
"longpolling_timeout_ms": 35000
}
Passez le curseur get_updates_buf à chaque requête subséquente pour ne recevoir que les nouveaux messages.
Envoi de messages
{
"msg": {
"to_user_id": "<target_user_id>",
"context_token": "<session_context_token>",
"item_list": [
{
"type": 1,
"text_item": { "text": "Bonjour !" }
}
]
}
}
Types de messages
| Type | Valeur |
|---|---|
| TEXT | 1 |
| IMAGE | 2 |
| VOICE | 3 |
| FILE | 4 |
| VIDEO | 5 |
Téléchargement de médias (Images, Fichiers, Vidéos)
Les fichiers multimédias sont chiffrés avec AES-128-ECB avant le téléchargement. Le processus :
- Appeler
getUploadUrlavec les métadonnées du fichier (taille, MD5) - Recevoir les paramètres de téléchargement CDN pré-signés
- Chiffrer le fichier avec AES-128-ECB
- Télécharger vers le CDN en utilisant l'URL pré-signée
- Référencer le fichier CDN dans
sendMessage
Problèmes courants et solutions
Le plugin refuse de se charger
Erreur : Le plugin refuse de se charger au démarrage
Solution : Vérifiez votre version d'OpenClaw. Le plugin v2.0.x nécessite >=2026.3.22.
openclaw --version
# Si obsolète, mettez d'abord à jour OpenClaw
Code QR expiré
Erreur : Le code QR expire avant d'être scanné
Solution : Exécutez à nouveau la commande de connexion. Les codes QR expirent après environ 30 secondes.
openclaw channels login --channel openclaw-weixin
Messages non reçus
Erreur : Les messages WeChat n'atteignent pas OpenClaw
Solution : Redémarrez la passerelle après la connexion.
openclaw gateway restart
Plusieurs comptes mélangeant les contextes
Erreur : Les réponses IA d'un compte apparaissent dans un autre
Solution : Activez l'isolation des contextes par canal.
openclaw config set agents.mode per-channel-per-peer
Cas d'utilisation réels
Assistant IA personnel
Connectez votre WeChat personnel à OpenClaw et demandez à un assistant IA de répondre aux messages lorsque vous êtes occupé. Configurez l'isolation des contextes afin que chaque contact reçoive des réponses personnalisées basées sur l'historique de leur conversation.
Support client pour petites entreprises
Exécutez plusieurs comptes WeChat pour différentes lignes d'activité. Chaque compte gère ses propres requêtes client avec une mémoire IA isolée. Aucune contamination croisée entre les comptes.
Tests développeur
Utilisez l'API HTTP JSON pour créer des intégrations personnalisées. Le protocole backend du plugin est entièrement documenté, ce qui facilite l'extension ou le remplacement du comportement par défaut.
Conclusion
La configuration d'OpenClaw avec WeChat prend moins de 5 minutes. Installez le plugin, scannez un code QR, redémarrez la passerelle — c'est fait. La configuration gratuite prend en charge plusieurs comptes, l'isolation des contextes et un support multimédia complet (images, voix, fichiers, vidéo).
Pour les développeurs, l'API HTTP JSON documentée rend les intégrations personnalisées simples.
Commencez par l'installateur en un clic :
npx -y @tencent-weixin/openclaw-weixin-cli install
Étape suivante : Une fois votre bot WeChat opérationnel, vous devrez probablement le connecter à des API externes — passerelles de paiement, CRM, services météorologiques, etc. Testez vos API avec Apidog pour vous assurer que votre bot envoie les bonnes données à chaque fois. Un niveau gratuit est disponible, aucune carte de crédit requise.
FAQ
Q : Cela fonctionne-t-il avec des comptes WeChat personnels ?
R : Oui. Contrairement à la plupart des outils d'automatisation WeChat, ce plugin fonctionne avec des comptes personnels. Aucun compte d'entreprise ou officiel n'est requis.
Q : Le plugin est-il gratuit ?
R : Oui. Le plugin @tencent-weixin/openclaw-weixin est gratuit et open-source. Vous avez seulement besoin d'une installation OpenClaw fonctionnelle.
Q : Puis-je exécuter plusieurs comptes WeChat simultanément ?
R : Oui. Exécutez openclaw channels login --channel openclaw-weixin pour chaque compte. Tous les comptes fonctionnent simultanément.
Q : Que se passe-t-il si je redémarre mon ordinateur ?
R : Les identifiants de connexion sont enregistrés localement. Vous n'avez pas besoin de scanner à nouveau le code QR après un redémarrage. Redémarrez simplement la passerelle avec openclaw gateway restart.
Q : Puis-je créer des intégrations personnalisées par-dessus cela ?
R : Oui. Le plugin expose une API HTTP JSON documentée avec 5 points de terminaison : getUpdates, sendMessage, getUploadUrl, getConfig et sendTyping. Si votre bot a besoin d'appeler des services externes, utilisez Apidog pour tester et valider vos intégrations API avant de les mettre en ligne.