Passer au contenu principal
Afficher en Markdown

WeChat (Weixin)

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.

Risques — à lire avant d'activer

  • 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.

Configuration

Depuis le tableau de bord (recommandé)

  1. Ouvrez Paramètres → Canaux de messagerie → WeChat dans le tableau de bord
  2. Cliquez sur Connecter via code QR
  3. Balayez le code avec l'application mobile WeChat et confirmez sur votre téléphone
  4. 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.

Depuis l'interface de ligne de commande

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 :

json
{ "weixin": { "enabled": true, "dm_policy": "allowlist", "allowed_user_ids": ["user-id-from-log"] } }

Ensuite : kirocrew restart

Politique d'accès

Who can message the bot correspond à weixin.dm_policy :

ValeurComportement
allowlist (par défaut)Seulement les ID d'utilisateur dans weixin.allowed_user_ids
openQuiconque envoie un message au bot
disabledTous 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.

Commandes

CommandeEffet
/new (ou 新对话, 清空)Démarrer une nouvelle session
/compactCompacter 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.

Notes sur le comportement

  • 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 mode auto ou trust, ou approuvez depuis le tableau de bord.
  • Texte seulement — les médias (images, messages vocaux, fichiers) ne sont pas encore pris en charge.

Configuration

À définir sous weixin dans config.json (ou via le panneau Paramètres) :

CléPar défautObjectif
weixin.enabledfalseActiver le canal
weixin.account_id—ID de compte du bot iLink (à partir de la connexion par code QR)
weixin.base_urlhttps://ilinkai.weixin.qq.comURL de base de l'API iLink
weixin.dm_policyallowlistallowlist / open / disabled
weixin.allowed_user_ids[]ID d'utilisateur autorisés lorsque allowlist
weixin.soft_threshold_pct80Suggérer la compaction au-delà de cette utilisation
weixin.hard_threshold_pct95Forcer la compaction au-delà de ce seuil

L'identifiant est lu depuis l'identifiant WEIXIN_TOKEN (env / .env / magasin d'identifiants).

Dépannage

ProblèmeSolution
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 journalSession expirée — relancez la connexion par code QR
errcode -2Limite de débit iLink; le sondeur ralentit automatiquement
Le bot ignore les MPVérifiez dm_policy — sous allowlist, l'expéditeur doit être listé
Messages de groupe ignorésAttendu : les identités de bot iLink ne reçoivent pas les événements de groupe
Images / messages vocaux / fichiers ignorésAttendu : texte seulement pour l'instant
Erreur de démarrage concernant aiohttpInstallez l'extra de messagerie
Page mise à jour : 25 septembre 2026