Antoine Laurent

Posted on Mar 25 • Originally published at apidog.com

Comment Utiliser OpenClaw Gratuitement avec WeChat ?

En bref : Connectez OpenClaw à WeChat en installant le plugin @tencent-weixin/openclaw-weixin, scannez un code QR pour autoriser votre compte, puis redémarrez la passerelle. L'installation complète prend moins de 5 minutes. Le plugin est gratuit, open-source et supporte plusieurs comptes WeChat en parallèle.

Essayez Apidog dès aujourd'hui

Introduction

Lancer un assistant IA sur WeChat peut paraître complexe : abonnements API coûteux, déploiement serveur, comptes entreprise... OpenClaw simplifie cela.

Le plugin @tencent-weixin/openclaw-weixin connecte votre compte WeChat personnel à la passerelle IA OpenClaw en quelques minutes. Aucun compte entreprise requis, aucun coût mensuel. Scannez un code QR et c'est parti.

Ce guide vous montre la configuration complète — installation du plugin, gestion multi-comptes, isolation des contextes de conversations. À la fin, votre WeChat aura un assistant IA opérationnel sur OpenClaw.

💡 Besoin d'appeler des API externes (météo, paiements, CRM) depuis votre bot WeChat ?

Utilisez Apidog pour concevoir, tester et documenter vos API avant la connexion au bot.

Prérequis

Avant de démarrer, assurez-vous d'avoir :

OpenClaw installé (version >=2026.3.22 pour le plugin v2.0.x)
L'interface CLI openclaw accessible dans votre terminal
Un compte WeChat personnel (pas besoin d’un compte entreprise)
Node.js installé (pour l'installateur rapide)

Vérifiez votre version OpenClaw :

openclaw --version

Si la version est trop ancienne, mettez à jour avant de continuer. Le plugin v2.0.x requiert 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 d’OpenClaw au lancement. Si la version n’est pas compatible, il ne se charge pas.

Étape 1 : Installer le plugin

Option A : Installation en un clic (recommandé)

npx -y @tencent-weixin/openclaw-weixin-cli install

Cette commande gère l’installation, la configuration et la préparation initiale automatiquement.

Option B : Installation manuelle

Si l’installateur rapide ne fonctionne pas, procédez 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

Après installation, connectez votre compte WeChat :

openclaw channels login --channel openclaw-weixin

Un code QR s’affiche dans le terminal.

Ouvrez WeChat sur votre téléphone, scannez le code, puis confirmez l’autorisation sur le téléphone.

Les identifiants sont stockés localement. Pas besoin de rescanner, sauf si vous vous déconnectez.

Étape 3 : Redémarrer la passerelle

Après autorisation, redémarrez la passerelle OpenClaw pour activer le plugin :

openclaw gateway restart

Votre compte WeChat est maintenant relié à OpenClaw. Les messages reçus seront traités par l’agent IA.

Étape 4 : Ajouter plusieurs comptes WeChat (optionnel)

OpenClaw gère plusieurs comptes WeChat en parallèle.

Pour ajouter un nouveau compte :

openclaw channels login --channel openclaw-weixin

Chaque scan de code QR ajoute un compte séparé. Tous fonctionnent sans interférence.

Étape 5 : Isoler les contextes de conversation (optionnel)

Par défaut, tous les canaux partagent le même contexte IA : vos conversations sur différents canaux peuvent partager la même “mémoire”.

Pour isoler le contexte de chaque compte WeChat :

openclaw config set agents.mode per-channel-per-peer

Chaque duo « compte WeChat + contact » aura son propre contexte IA. Pas de mélange d’historique entre comptes.

Comment le plugin fonctionne en coulisses

En-têtes d’authentification

Toutes les requêtes API utilisent ces headers :

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 expose 5 endpoints HTTP JSON :

Point de terminaison	Chemin	Objectif
getUpdates	`getupdates`	Long-polling pour messages entrants
sendMessage	`sendmessage`	Envoyer texte/image/vidéo/fichier
getUploadUrl	`getuploadurl`	Récupérer l’URL de téléchargement CDN
getConfig	`getconfig`	Obtenir la config du compte (ticket, etc.)
sendTyping	`sendtyping`	Afficher/masquer l’indicateur de saisie

Réception des messages (long polling)

Exemple d’échange pour récupérer de nouveaux messages :

// Requête
{
  "get_updates_buf": ""
}

// Réponse
{
  "ret": 0,
  "msgs": [...],
  "get_updates_buf": "<new_cursor>",
  "longpolling_timeout_ms": 35000
}

Transmettez get_updates_buf à chaque requête suivante 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 sont chiffrés avec AES-128-ECB avant envoi.

Procédure :

Appeler getUploadUrl avec les métadonnées (taille, MD5)
Recevoir l’URL de téléchargement CDN signée
Chiffrer le fichier (AES-128-ECB)
Uploader sur le CDN via l’URL reçue
Référencer le fichier dans sendMessage

Problèmes courants et solutions

Le plugin refuse de se charger

Erreur : Refus de chargement

Solution : Vérifiez la version d’OpenClaw. Le plugin v2.0.x nécessite >=2026.3.22.

openclaw --version
# Si besoin, mettez à jour OpenClaw

Code QR expiré

Erreur : Le code QR a expiré

Solution : Relancez la commande de connexion. Les codes QR expirent après ~30s.

openclaw channels login --channel openclaw-weixin

Messages non reçus

Erreur : Les messages WeChat n’arrivent pas dans OpenClaw

Solution : Redémarrez la passerelle après la connexion.

openclaw gateway restart

Plusieurs comptes, contextes mélangés

Erreur : Les réponses IA d’un compte apparaissent dans l’autre

Solution : Isolez les contextes par canal.

openclaw config set agents.mode per-channel-per-peer

Cas d’utilisation réels

Assistant IA personnel

Connectez votre WeChat perso à OpenClaw. Laissez un assistant IA répondre à vos messages quand vous êtes occupé.

Activez l’isolation des contextes pour des réponses personnalisées par contact.

Support client petites entreprises

Gérez plusieurs comptes WeChat pour différents services.

Chaque compte a sa propre mémoire IA isolée, aucun mélange de conversations entre comptes.

Tests développeur

Utilisez l’API HTTP JSON pour créer des intégrations sur-mesure.

Le protocole backend du plugin est documenté pour faciliter l’extension ou la personnalisation.

Conclusion

La connexion d’OpenClaw à WeChat prend moins de 5 minutes :

Installez le plugin, scannez un QR, redémarrez la passerelle.

Vous profitez d’une configuration gratuite, multicomptes, isolation des contextes et support multimédia (image, voix, fichier, vidéo).

Pour les développeurs, l’API HTTP JSON documentée rend l’intégration personnalisée rapide et fiable.

Démarrez avec :

npx -y @tencent-weixin/openclaw-weixin-cli install

Étape suivante : Dès que votre bot WeChat fonctionne, vous voudrez sans doute le connecter à des API externes (paiement, CRM, météo, etc).

Testez vos API avec Apidog pour garantir que votre bot transmet les bonnes données à chaque appel. Niveau gratuit disponible, sans carte bancaire.

FAQ

Q : Cela fonctionne-t-il avec des comptes WeChat personnels ?

R : Oui. Contrairement à d’autres solutions, ce plugin fonctionne avec des comptes personnels. Aucune nécessité de compte entreprise.

Q : Le plugin est-il gratuit ?

R : Oui, il est open-source et gratuit. Vous n’avez besoin que d’une installation OpenClaw.

Q : Puis-je connecter plusieurs comptes WeChat en même temps ?

R : Oui. Exécutez openclaw channels login --channel openclaw-weixin pour chaque compte à connecter.

Q : Que se passe-t-il si je redémarre mon ordinateur ?

R : Les identifiants restent stockés localement. Après redémarrage, il suffit de relancer la passerelle avec openclaw gateway restart.

Q : Puis-je créer des intégrations personnalisées au-dessus de ce plugin ?

R : Oui. Le plugin expose une API HTTP JSON documentée avec 5 endpoints (getUpdates, sendMessage, getUploadUrl, getConfig, sendTyping).

Si votre bot doit appeler des services externes, utilisez Apidog pour tester et valider vos API avant mise en production.

DEV Community