DingTalk

Conecta tu instancia de Claw a DingTalk usando el modo Stream

Conecta DingTalk (钉钉) a tu instancia de Claw usando el modo Stream — una conexión basada en WebSocket que no requiere una URL pública.

​

Requisitos previos

• Una cuenta de DingTalk con acceso de administrador de empresa
• Una instancia de Claw (crea una aquí)

​

Guía de configuración

1. Crear una aplicación de DingTalk

   1. Ve a DingTalk Open Platform
   2. Haz clic en Application Development → Enterprise Internal Development
   3. Haz clic en Create Application
   4. Ingresa un nombre y descripción para la aplicación
   5. Haz clic en Confirm
2. Habilitar la capacidad de Robot

   1. En tu aplicación, ve a App Features → Robot
   2. Habilita la configuración del robot
   3. Selecciona Stream Mode (recomendado — no se necesita una URL pública)
   4. Haz clic en Publish

   El modo Stream utiliza WebSocket, por lo que tu instancia de Claw no necesita una URL de webhook accesible públicamente. Esta es la configuración más sencilla.

3. Obtener credenciales

   1. Ve a Basic Information → Credentials
   2. Copia el AppKey y el AppSecret
4. Publicar la aplicación

   1. Ve a Version Management
   2. Crea una nueva versión (como mínimo una versión de prueba)
   3. Establece el rango de visibilidad (qué usuarios/departamentos pueden ver el bot)
   4. Envía y publica
5. Abrir la LemonClaw WebUI

   1. Si usas Claw alojado, ve a tu Claw Dashboard y haz clic en Open WebUI
   2. Si autoalojas LemonClaw, abre tu propia WebUI (por ejemplo http://your-ip:18789) e inicia sesión con tu token
   3. En la WebUI, ve a Settings → Channels
   4. Expande la sección DingTalk
   5. Pega tu AppKey y AppSecret
   6. Haz clic en Save
6. Comenzar a chatear

   1. En DingTalk, busca tu bot por su nombre
   2. Envíale un mensaje
   3. ¡El primer usuario se empareja automáticamente como el propietario — no se necesita código!
   4. ¡Comienza a chatear con la IA!

​

Configuración de grupo

Configura el comportamiento del chat grupal en la pestaña Channels de tu WebUI:

Configuración	Opciones	Descripción
Group Policy	Abierto (predeterminado) / Allowlist / Deshabilitado	Controla quién puede activar el bot en los grupos
Group Allowed Users	Lista de IDs de usuario	Solo estos usuarios pueden activar el bot (modo allowlist)

DingTalk siempre requiere una @mención para activar el bot en los grupos — esta es una limitación de la plataforma y no se puede configurar. El filtrado por IDs de grupo no está disponible para DingTalk; utiliza la configuración de Group Policy para controlar el acceso.

​

Solución de problemas

El soporte actual de DingTalk en LemonClaw aún no es una integración completa de workbench grupal. Los mensajes de grupo solo entran al flujo de IA cuando @mencionan al bot, y las respuestas prefieren el sessionWebhook original.

El bot no responde

• Verifica que el AppKey y el AppSecret sean correctos
• Comprueba que la aplicación esté publicada (al menos la versión de prueba)
• Asegúrate de que el modo Stream mode esté seleccionado en la configuración del robot
• Verifica que el bot sea visible para tu cuenta de usuario

La conexión se cae con frecuencia

• El modo Stream mantiene una conexión WebSocket persistente
• Las desconexiones breves son normales — el bot se reconectará automáticamente
• Si el problema persiste, intenta reiniciar la instancia desde el dashboard