Canal DingTalk OpenClaw

OpenClaw se connecte à DingTalk via le mode Stream (connexion longue WebSocket) de la plateforme ouverte DingTalk. Contrairement aux Webhooks traditionnels, le mode Stream permet au Gateway d'initier activement une connexion WebSocket vers les serveurs DingTalk, recevant les événements en temps réel sans IP publique ni domaine. Flux de messages : L'utilisateur envoie un message dans DingTalk → Plateforme ouverte DingTalk → Push Stream vers le Gateway → OpenClaw traite avec l'IA → Réponse via l'API Bot DingTalk → Message livré dans DingTalk. Cette architecture est idéale pour les déploiements auto-hébergés derrière un NAT ou un pare-feu d'entreprise. Le Gateway gère automatiquement la connexion et traite les reconnexions avec un backoff exponentiel.

Deux plugins communautaires sont disponibles pour connecter DingTalk : • @soimy/dingtalk — Le plugin le plus populaire, activement maintenu par la communauté. Supporte les formats de réponse Markdown et AI Card, complet et stable. • @dingtalk-real-ai/dingtalk-connector — Projet officiellement lié à DingTalk, axé sur les réponses streaming AI Card, supporte le routage multi-agents et le mode asynchrone, nécessite OpenClaw v0.7.7+. Les deux plugins utilisent le mode Stream, l'expérience principale est identique. Recommandation : les débutants choisiront la version @soimy (plus de documentation), ceux qui ont besoin du multi-agents ou du traitement asynchrone choisiront la version @dingtalk-real-ai.

# Installer la version @soimy (recommandée)
openclaw plugins install @soimy/dingtalk

# Ou installer la version @dingtalk-real-ai
openclaw plugins install @dingtalk-real-ai/dingtalk-connector

La configuration de l'intégration DingTalk nécessite la création d'une application sur la plateforme ouverte : 1. Connectez-vous à open-dev.dingtalk.com et accédez à la console développeur. 2. Cliquez sur « Créer une application », sélectionnez « Développement interne d'entreprise » → type « Bot ». 3. Entrez le nom et la description de l'application. Une fois créée, copiez le ClientID (AppKey, format dingXXX) et le ClientSecret (AppSecret) sur la page « Identifiants et informations de base ». 4. Dans la configuration du bot, sélectionnez le **mode Stream** comme mode de réception des messages (pas le mode HTTP). 5. Dans la gestion des permissions, ajoutez les permissions nécessaires : - qyapi_robot_sendmsg (envoi de messages bot) - Card.Instance.Write (écriture d'instance de carte) - Card.Streaming.Write (écriture de carte streaming) - mediaId.download et mediaId.upload (téléchargement/envoi de fichiers médias) 6. Publiez l'application et attendez l'approbation de l'administrateur de l'organisation.

# Via variables d'environnement
export DINGTALK_CLIENT_ID="dingXXXXXX"
export DINGTALK_CLIENT_SECRET="your_app_secret"

# Ou via CLI
openclaw channels add

Le plugin DingTalk supporte des politiques de messages flexibles : **Politique de DM (dmPolicy)** : • open — Toute personne envoyant un message direct au bot reçoit une réponse • disabled — La fonctionnalité DM est désactivée **Politique de groupe (groupPolicy)** : • open — Tout membre du groupe peut déclencher le bot en le @mentionnant • disabled — Les messages de groupe sont complètement ignorés Dans les discussions de groupe, une @mention du bot est requise par défaut pour éviter les réponses intempestives dans les groupes actifs.

{
  "channels": {
    "dingtalk": {
      "dmPolicy": "open",
      "groupPolicy": "open"
    }
  }
}

Le plugin DingTalk supporte plusieurs formats de réponse : • **Texte** — Réponses en texte brut basiques • **Markdown** — Supporte les titres, listes, liens et autres mises en forme, recommandé par défaut • **AI Card (streaming)** — Effet machine à écrire similaire à ChatGPT, le message se met à jour progressivement dans une carte Le streaming AI Card offre la meilleure expérience utilisateur — les messages sont mis à jour sur place sans générer de messages multiples. Nécessite les permissions Card dans l'application DingTalk.

{
  "channels": {
    "dingtalk": {
      "messageType": "markdown",
      "streaming": true
    }
  }
}

Le plugin DingTalk pour OpenClaw gère plusieurs types de messages : **Réception** : Texte, images, voix (reconnaissance vocale automatique), vidéo, fichiers **Traitement de fichiers** : .docx, .pdf, .txt, .md, .json, .xlsx, .pptx, .zip et d'autres formats peuvent être lus et analysés par l'IA **Envoi** : Texte, Markdown, AI Card, images, fichiers Les messages vocaux sont automatiquement convertis en texte avant d'être envoyés à l'IA — aucune configuration supplémentaire nécessaire.

Avec la version @dingtalk-real-ai du plugin, vous pouvez configurer le routage multi-agents pour que différents agents IA traitent différents types de conversations. Par exemple, les messages directs vont à l'assistant général et certaines discussions de groupe vont à un agent spécialisé. Via la configuration des bindings dans OpenClaw, vous pouvez contrôler finement l'attribution des agents pour chaque conversation.

{
  "bindings": [
    { "agentId": "main", "match": { "channel": "dingtalk", "peer": { "kind": "direct" } } },
    { "agentId": "tech-support", "match": { "channel": "dingtalk", "peer": { "kind": "group" } } }
  ]
}

OpenClaw fournit plusieurs commandes pour gérer votre bot DingTalk : • openclaw gateway status — Vérifier l'état de connexion du Gateway • openclaw gateway restart — Redémarrer le service Gateway • openclaw logs --follow — Voir les logs en temps réel • openclaw channels add — Ajouter un canal interactivement • openclaw plugins list — Voir les plugins installés • openclaw plugins update @soimy/dingtalk — Mettre à jour le plugin DingTalk • openclaw doctor — Diagnostic complet