Passer au contenu principal
Afficher en Markdown

WeCom

Crew se connecte à WeCom (企业微信) grâce à son API de robot d'IA via un WebSocket sortant. Créez le robot dans votre console d'administration WeCom, ajoutez deux valeurs, et vous voilà en train de clavarder. Les réponses sont diffusées en direct.

Configuration

À partir du tableau de bord (recommandé)

  1. Dans la console d'administration WeCom, ouvrez 应用管理 → AI 智能体 et créez un robot. Notez le Bot ID et le Secret depuis sa page de paramètres.
  2. Ouvrez Settings → Canaux de messagerie → WeCom dans le tableau de bord
  3. Collez le Bot ID et le Secret
  4. Ajoutez les userids que vous voulez autoriser (chaque membre WeCom a un userid / 账号)
  5. Cliquez sur Save — la passerelle redémarre et se connecte

Cherchez WeCom WS connected and subscribed dans le badge de statut. Envoyez un message au robot dans WeCom.

À partir de la CLI

bash
# Save credentials to ~/.kiro/crew/.env echo "WECOM_BOT_ID=your-bot-id" >> ~/.kiro/crew/.env echo "WECOM_SECRET=your-bot-secret" >> ~/.kiro/crew/.env

Dans ~/.kiro/crew/config.json :

json
{ "wecom": { "enabled": true, "allowed_users": [{ "userid": "zhangsan", "name": "Zhang San" }] } }

Ensuite : kirocrew restart

Envoyez un message au robot dans WeCom. S'il reste silencieux, confirmez que votre userid est autorisé.

Qui peut y accéder

  • Le propriétaire (KIROCREW_OWNER_ID) plus toute personne dans allowed_users
  • Accès à toute l'entreprise : définissez "allow_all_users": true pour éviter de lister les utilisateurs individuellement — il s'agit d'une adhésion explicite (une liste vide ne signifie jamais « tout le monde »)
  • Le robot d'IA WeCom ne transporte que des messages directs — une conversation par userid
  • Toute autre personne est silencieusement rejetée et enregistrée dans le journal d'audit

Commandes

CommandeEffet
/new (ou 新对话, 清空)Démarrer une nouvelle conversation
/compactCompresser le contexte

Notes sur le comportement

  • Le robot répond aux messages — il ne peut pas démarrer une conversation de lui-même
  • Aucun bouton — les requêtes OPTIONS arrivent en texte brut; répondez simplement normalement
  • Seulement deux valeurs nécessaires : Bot ID et Secret. Aucun corp ID, agent ID, URL de rappel ou clé AES

Configuration

CléValeur par défautObjectif
wecom.enabledfalseActive le canal
wecom.allowed_users[]Entrées { "userid", "name" } (vide = propriétaire seulement)
wecom.allow_all_usersfalseAutoriser tous les membres de l'organisation
wecom.soft_threshold_pct80Suggérer /compact au-delà de ce seuil
wecom.hard_threshold_pct95Coupure stricte
wecom.ws_urlwss://openws.work.weixin.qq.comPoint de terminaison du robot d'IA WeCom

Identifiants dans ~/.kiro/crew/.env : WECOM_BOT_ID et WECOM_SECRET.

Dépannage

ProblèmeSolution
Aucune réponseLe userid de l'expéditeur n'est pas autorisé ou enabled est false
Aucun channel started dans les journauxUn identifiant n'est pas défini
Se connecte puis devient silencieuxLe robot a peut-être été retiré de la console WeCom — rajoutez-le et redémarrez

Suite

Page mise à jour : 25 septembre 2026