Canal DingTalk de OpenClaw

OpenClaw se conecta a DingTalk a través del modo Stream (conexión larga WebSocket) de la plataforma abierta de DingTalk. A diferencia de los Webhooks tradicionales, el modo Stream permite que el Gateway inicie activamente una conexión WebSocket con los servidores de DingTalk, recibiendo eventos en tiempo real sin necesidad de IP pública ni dominio. Flujo de mensajes: El usuario envía un mensaje en DingTalk → Plataforma abierta DingTalk → Push Stream al Gateway → OpenClaw procesa con IA → Respuesta vía API Bot DingTalk → Mensaje entregado en DingTalk. Esta arquitectura es ideal para despliegues autoalojados detrás de NAT o firewalls corporativos. El Gateway gestiona automáticamente la conexión y maneja las reconexiones con backoff exponencial.

Hay dos plugins comunitarios disponibles para conectar DingTalk: • @soimy/dingtalk — El plugin más popular, mantenido activamente por la comunidad. Soporta formatos de respuesta Markdown y AI Card, completo y estable. • @dingtalk-real-ai/dingtalk-connector — Proyecto vinculado oficialmente a DingTalk, enfocado en respuestas streaming con AI Card, soporta enrutamiento multi-agente y modo asíncrono, requiere OpenClaw v0.7.7+. Ambos plugins usan el modo Stream, la experiencia principal es idéntica. Recomendación: principiantes usen la versión @soimy (más documentación), quienes necesiten multi-agente o procesamiento asíncrono usen la versión @dingtalk-real-ai.

# Instalar versión @soimy (recomendada)
openclaw plugins install @soimy/dingtalk

# O instalar versión @dingtalk-real-ai
openclaw plugins install @dingtalk-real-ai/dingtalk-connector

Configurar la integración DingTalk requiere crear una aplicación en la plataforma abierta: 1. Inicia sesión en open-dev.dingtalk.com y accede a la consola de desarrollador. 2. Haz clic en "Crear aplicación", selecciona "Desarrollo interno de empresa" → tipo "Bot". 3. Introduce el nombre y descripción de la app. Una vez creada, copia el ClientID (AppKey, formato dingXXX) y el ClientSecret (AppSecret) en la página de "Credenciales e información básica". 4. En la configuración del bot, selecciona **modo Stream** como modo de recepción de mensajes (no modo HTTP). 5. En la gestión de permisos, añade los permisos necesarios: - qyapi_robot_sendmsg (envío de mensajes del bot) - Card.Instance.Write (escritura de instancia de tarjeta) - Card.Streaming.Write (escritura de tarjeta streaming) - mediaId.download y mediaId.upload (carga/descarga de archivos multimedia) 6. Publica la aplicación y espera la aprobación del administrador de la organización.

# Vía variables de entorno
export DINGTALK_CLIENT_ID="dingXXXXXX"
export DINGTALK_CLIENT_SECRET="your_app_secret"

# O vía CLI
openclaw channels add

El plugin de DingTalk soporta políticas de mensajes flexibles: **Política de DM (dmPolicy)**: • open — Cualquier persona que envíe un mensaje directo al bot recibe respuesta • disabled — La funcionalidad de DM está desactivada **Política de grupo (groupPolicy)**: • open — Cualquier miembro del grupo puede activar el bot con @mención • disabled — Los mensajes grupales se ignoran completamente En chats grupales, se requiere @mención del bot por defecto para evitar respuestas innecesarias en grupos activos.

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

El plugin de DingTalk soporta múltiples formatos de respuesta: • **Texto** — Respuestas de texto plano básicas • **Markdown** — Soporta títulos, listas, enlaces y otros formatos, recomendado por defecto • **AI Card (streaming)** — Efecto de máquina de escribir similar a ChatGPT, el mensaje se actualiza progresivamente en una tarjeta El streaming con AI Card ofrece la mejor experiencia de usuario — los mensajes se actualizan in situ sin generar múltiples mensajes. Requiere permisos de Card en la aplicación DingTalk.

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

El plugin de DingTalk para OpenClaw maneja múltiples tipos de mensajes: **Recepción**: Texto, imágenes, voz (reconocimiento automático de voz), video, archivos **Procesamiento de archivos**: .docx, .pdf, .txt, .md, .json, .xlsx, .pptx, .zip y otros formatos pueden ser leídos y analizados por la IA **Envío**: Texto, Markdown, AI Card, imágenes, archivos Los mensajes de voz se convierten automáticamente a texto antes de enviarse a la IA — no se necesita configuración adicional.

Con la versión @dingtalk-real-ai del plugin, puedes configurar enrutamiento multi-agente para que diferentes agentes IA manejen diferentes tipos de conversaciones. Por ejemplo, los mensajes directos van al asistente general y ciertos chats grupales van a un agente especializado. Mediante la configuración de bindings en OpenClaw, puedes controlar con precisión la asignación de agentes para cada conversación.

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

OpenClaw proporciona varios comandos para gestionar tu bot de DingTalk: • openclaw gateway status — Verificar el estado de conexión del Gateway • openclaw gateway restart — Reiniciar el servicio Gateway • openclaw logs --follow — Ver logs en tiempo real • openclaw channels add — Añadir canal interactivamente • openclaw plugins list — Ver plugins instalados • openclaw plugins update @soimy/dingtalk — Actualizar el plugin de DingTalk • openclaw doctor — Diagnóstico completo