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.
Privilégiez WeCom pour tout ce qui est critique pour les affaires.
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.
interactive, les outils nécessitant une approbation sont refusés par défaut. Utilisez le mode auto ou trust, ou approuvez depuis le tableau de bord.À 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)