Connectez le Crew à WeChat personnel (微信) grâce à l'API du bot iLink de Tencent. La connexion se fait par balayage de code QR depuis le tableau de bord; les messages arrivent par interrogation HTTP longue (long-poll), donc aucun point de terminaison public, webhook ou tunnel n'est requis.
- Surface non officielle. L'API du bot iLink n'est pas un produit de développeur Tencent publié officiellement. Le comportement peut changer sans préavis, et l'utilisation d'un compte personnel comme bot pourrait violer les conditions d'utilisation de WeChat. Les comptes peuvent être limités ou bannis.
- MP seulement. L'identité du bot iLink ne reçoit généralement pas les événements de groupe. Le clavardage de groupe n'est pas pris en charge.
- Un seul sondeur par identifiant. Un seul passerelle à la fois peut effectuer l'interrogation longue sur un identifiant de bot donné.
Privilégiez WeCom pour tout ce qui est critique pour les affaires.
- Ouvrez Paramètres → Canaux de messagerie → WeChat dans le tableau de bord
- Cliquez sur Connecter via code QR
- Balayez le code avec l'application mobile WeChat et confirmez sur votre téléphone
- Redémarrez la passerelle — la pastille de statut passe à Connecté
L'identifiant du bot est écrit côté serveur (dans le magasin d'identifiants, jamais renvoyé au navigateur). Seuls l'ID de compte non secret et le statut de connexion sont exposés au tableau de bord.
Le flux par code QR requiert l'interface du tableau de bord — il n'existe aucun chemin uniquement en ligne de commande pour la connexion initiale. Après la connexion via le tableau de bord, gérez les paramètres dans config.json :
{ "weixin": { "enabled": true, "dm_policy": "allowlist", "allowed_user_ids": ["user-id-from-log"] } }
Ensuite : kirocrew restart
Who can message the bot correspond à weixin.dm_policy :
| Valeur | Comportement |
|---|---|
allowlist (par défaut) | Seulement les ID d'utilisateur dans weixin.allowed_user_ids |
open | Quiconque envoie un message au bot |
disabled | Tous les messages sont ignorés |
La valeur par défaut est allowlist avec une liste vide, ce qui n'autorise personne — un bot nouvellement connecté ignore chaque MP jusqu'à ce que vous ajoutiez un ID. Pour recueillir un ID d'utilisateur, demandez à la personne d'envoyer un MP au bot une fois et lisez l'ID dans le journal de la passerelle.
| Commande | Effet |
|---|---|
/new (ou 新对话, 清空) | Démarrer une nouvelle session |
/compact | Compacter le contexte de session sur place |
Le contexte est géré automatiquement : à soft_threshold_pct (80 %), le bot suggère /compact ou /new; à hard_threshold_pct (95 %), il se compacte de lui-même.
- Une réponse par tour — iLink ne peut pas modifier un message envoyé, donc la réponse est mise en mémoire tampon et livrée une fois le tour terminé (pas diffusée en continu). L'indicateur natif « en train d'écrire… » s'exécute pendant toute la durée.
- Le Markdown est préservé — les clients iLink le rendent. Les réponses de plus de 4000 caractères sont divisées aux limites de paragraphe ou de bloc de code.
- Les appels d'outils et le raisonnement ne sont pas répétés dans le clavardage (ils deviendraient chacun une bulle distincte).
- Aucun bouton d'approbation — iLink n'a aucun contrôle interactif. En mode
interactive, les outils nécessitant une approbation sont refusés par défaut. Utilisez le modeautooutrust, ou approuvez depuis le tableau de bord. - Texte seulement — les médias (images, messages vocaux, fichiers) ne sont pas encore pris en charge.
À définir sous weixin dans config.json (ou via le panneau Paramètres) :
| Clé | Par défaut | Objectif |
|---|---|---|
weixin.enabled | false | Activer le canal |
weixin.account_id | — | ID de compte du bot iLink (à partir de la connexion par code QR) |
weixin.base_url | https://ilinkai.weixin.qq.com | URL de base de l'API iLink |
weixin.dm_policy | allowlist | allowlist / open / disabled |
weixin.allowed_user_ids | [] | ID d'utilisateur autorisés lorsque allowlist |
weixin.soft_threshold_pct | 80 | Suggérer la compaction au-delà de cette utilisation |
weixin.hard_threshold_pct | 95 | Forcer la compaction au-delà de ce seuil |
L'identifiant est lu depuis l'identifiant WEIXIN_TOKEN (env / .env / magasin d'identifiants).
| Problème | Solution |
|---|---|
| Statut bloqué sur « Signed in — restart to connect » | Redémarrez la passerelle; les identifiants sont lus une seule fois au démarrage |
errcode -14 dans le journal | Session expirée — relancez la connexion par code QR |
errcode -2 | Limite de débit iLink; le sondeur ralentit automatiquement |
| Le bot ignore les MP | Vérifiez dm_policy — sous allowlist, l'expéditeur doit être listé |
| Messages de groupe ignorés | Attendu : les identités de bot iLink ne reçoivent pas les événements de groupe |
| Images / messages vocaux / fichiers ignorés | Attendu : texte seulement pour l'instant |
Erreur de démarrage concernant aiohttp | Installez l'extra de messagerie |
WeChat (Weixin)