Skip to content

OpenClaw ¿Puede conectarse a DingTalk y cómo ​

En la empresa de Ajie todo el personal usa DingTalk: calendarios, tareas pendientes e informes diarios están ahí. Siguió el tutorial e instaló OpenClaw, pero al revisar la lista de canales de la documentación oficial encontró Feishu y WeChat Work, pero no DingTalk por ningún lado.

Primero deja clara la línea divisoria de este asunto:

Pon a prueba tus conocimientos¿Está DingTalk en la lista de canales de la documentación oficial de OpenClaw?

El núcleo de OpenClaw no admite DingTalk, pero el equipo de DingTalk mantiene un complemento externo que, una vez instalado, permite usar OpenClaw en chats privados y grupales de DingTalk. El repositorio de este complemento se autodenomina "creación oficial de DingTalk", pero la documentación oficial de OpenClaw no lo incluye; si surge algún problema, hay que acudir al repositorio del complemento, no a OpenClaw.

Qué podrás hacer al terminar ​

  • Instalar el complemento de DingTalk con un solo comando y crear el bot escaneando el código QR
  • Si el escaneo del código falla, rellenar manualmente AppKey / AppSecret para completar la configuración
  • Conversar con OpenClaw en DingTalk y saber qué configuración cambiar cuando no responde en chats grupales

Quién hizo este complemento ​

ProyectoContenido
Repositoriohttps://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector
MantenedorCuenta de organización de GitHub DingTalk-Real-AI, con la descripción del repositorio "Official OpenClaw DingTalk channel plugin | complemento oficial de DingTalk OpenClaw"
Paquete npm@dingtalk-real-ai/dingtalk-connector
Última versión0.8.27 (2026-10-20)
Estrellas2,128 (consulta de 2026-11-20)
LicenciaMIT
Requisito de OpenClaw≥ 2026.8.1; para OpenClaw más antiguos, usar el complemento 0.8.25

Capacidades listadas en el README: recibir y responder mensajes de chats grupales y privados; @mencionar a miembros; respuestas en streaming con AI Card; creación, anexado y búsqueda de documentos de DingTalk; recordatorios DING urgentes; tareas pendientes personales; hojas de cálculo de IA; eventos de calendario; informes diarios y semanales. Las tareas pendientes de grupo y los archivos de la nube están marcados como "Coming Soon" y aún no se pueden usar.

Existe otro complemento comunitario soimy/openclaw-channel-dingtalk (mantenido por una cuenta personal, 1,662 estrellas, consulta de 2026-11-20). Esta lección solo cubre el del equipo de DingTalk.

  • Sé que este complemento no forma parte del núcleo de OpenClaw y que los problemas deben reportarse en el repositorio del complemento

Lee las advertencias de seguridad antes de usarlo ​

El README del complemento incluye, antes de las instrucciones de instalación, una sección aparte titulada "Advertencias de seguridad y riesgos (lectura obligatoria antes de usar)", cuyos puntos clave son:

  • Se conecta a las capacidades de automatización de IA de OpenClaw, con riesgos inherentes como alucinaciones del modelo, ejecución incontrolable e inyección de prompts.
  • Una vez autorizado, OpenClaw operará en DingTalk con tu identidad de usuario dentro del alcance autorizado, lo que puede provocar filtraciones de datos sensibles u operaciones no autorizadas.
  • El complemento activa por defecto múltiples capas de protección de seguridad, y el README recomienda encarecidamente no modificar ninguna configuración de seguridad predeterminada.
  • Se recomienda usarlo como asistente de conversación personal y evitar implementarlo directamente en entornos de producción empresariales; si lo usas en una cuenta de empresa, debes cumplir las normas de seguridad de la información de tu empresa.

Además, la versión de referencia de este tutorial, OpenClaw 2026.10.9, está afectada por el aviso de alta gravedad GHSA-pw3x. Antes de conectar OpenClaw al IM de tu empresa, sigue primero canales de actualización y versiones para actualizar a 2026.11.4 o superior, o a 2026.10.33.

  • He leído las advertencias de seguridad del complemento y he confirmado mi versión de OpenClaw

Paso 1: confirma la versión de OpenClaw ​

Por qué: desde la versión 0.8.26 el complemento usa el nuevo SDK de complementos de OpenClaw 2, que requiere como mínimo OpenClaw 2026.8.1.

bash
openclaw -v

Deberías ver: un número de versión no inferior a 2026.8.1. La versión de referencia de este tutorial, 2026.10.9, cumple el requisito, pero actualiza primero a una versión no afectada por el aviso según la sección anterior.

  • Número de versión ≥ 2026.8.1

Paso 2: instalar con un solo comando y autorizar escaneando el código QR ​

Por qué: es el método recomendado por el README, que completa la instalación del complemento y la creación del bot de una sola vez.

bash
npx -y @dingtalk-real-ai/dingtalk-connector install

La terminal mostrará un código QR de autorización de DingTalk. Escanea el código con laapp móvil de DingTalk y pulsa "Crear un nuevo bot con un clic".

Deberías ver: la terminal imprime Success! Bot configured., lo que indica que la autorización se completó.

Luego reinicia el Gateway para que el nuevo canal surta efecto:

bash
openclaw gateway restart

El README aclara expresamente: si el escaneo del código falla (tiempo de espera agotado, el código QR no se muestra, etc.), esto no afecta la instalación del complemento en sí, y puedes continuar con el paso 3 para configurarlo manualmente.

  • He visto Success! Bot configured. y he reiniciado el Gateway

Paso 3 (si el escaneo del código falla): rellenar las credenciales manualmente ​

Por qué: cuando el escaneo del código no está disponible, crea la aplicación tú mismo en la plataforma abierta de DingTalk y escribe las credenciales en la configuración de OpenClaw.

  1. Abre la plataforma abierta de DingTalk https://open-dev.dingtalk.com/ y entra en "Desarrollo de aplicaciones".
  2. En la página de detalles de la aplicación, crea con un clic una aplicación de bot de OpenClaw.
  3. En "Credenciales e información básica", copia AppKey (Client ID) y AppSecret (Client Secret).

Edita ~/.openclaw/openclaw.json (en Windows es C:\Users\<你的用户名>\.openclaw\openclaw.json) y añade bajo channels:

json
{
  "channels": {
    "dingtalk-connector": {
      "enabled": true,
      "clientId": "dingxxxxxxxxx",
      "clientSecret": "your_app_secret"
    }
  }
}

Si el archivo ya tiene contenido, añade solo el bloque dingtalk-connector bajo el nodo channels. Estos dos valores son las credenciales únicas del bot: no las envíes a grupos ni las subas a un repositorio de código. Después de modificar, ejecuta openclaw gateway restart.

Deberías ver: el Gateway se reinicia con normalidad, sin errores de configuración.

  • He rellenado clientId y clientSecret en channels.dingtalk-connector

Paso 4: di la primera frase en DingTalk ​

Por qué: el chat privado es la verificación de extremo a extremo más rápida.

Busca en DingTalk el bot recién creado y envíale una frase por chat privado.

Deberías ver: el bot responde. El complemento admite respuestas en streaming con AI Card, y la tarjeta de mensajes mostrará cambios de estado como pensando, generando, completado.

Luego añade el bot a un grupo de prueba y pregúntale @mencionándolo.

  • Has recibido una respuesta tanto en el chat privado como en el grupal

¿No funcionó? ​

La página de preguntas frecuentes del repositorio del complemento enumera varios casos:

BuscarLo que me pasa es…

Toca uno para ver.

Para el caso en que el chat grupal solo responde con el mensaje de respaldo, la configuración que hay que añadir es:

json
{
  "messages": {
    "groupChat": {
      "visibleReplies": "automatic"
    }
  }
}

Luego openclaw gateway restart. La razón que da la página de preguntas frecuentes es: por defecto, en el chat grupal solo se responde mediante la herramienta de mensajes, el plugin no obtiene el texto y, por lo tanto, cae en el mensaje de respaldo. Las versiones más recientes del plugin incluyen directamente esta guía de corrección en el mensaje de respaldo.

Para más problemas, consulta el docs/TROUBLESHOOTING.md y los Issues del repositorio del plugin. Los problemas propios de OpenClaw (gateway, modelos, multicanal) los README te remite a los Issues de openclaw/openclaw.

Punto de control ​

  • Puedo explicar con claridad: DingTalk no es un canal central de OpenClaw, sino que se usa un plugin externo mantenido por el equipo de DingTalk
  • Mi OpenClaw ≥ 2026.8.1, y ya he actualizado a una versión no afectada por GHSA-pw3x
  • El bot responde en el chat privado de DingTalk
  • Cuando en el grupo solo responde con el mensaje de respaldo al @ mencionarlo, sé que hay que modificar messages.groupChat.visibleReplies

Malentendidos comunes ​

Pensar que el "complemento oficial de DingTalk" equivale a soporte oficial de OpenClaw. "Oficial" es una autodescripción del repositorio del complemento, que indica que lo desarrolla el equipo de DingTalk. La documentación oficial de OpenClaw no incluye el canal de DingTalk; la compatibilidad y los problemas del complemento son responsabilidad del repositorio del complemento.

**Pensar que, una vez instalado, se puede usar sin preocupaciones en toda la empresa. ** El propio README del plugin recomienda usarlo como asistente personal y evitar desplegarlo directamente en entornos de producción empresariales; tras la autorización, OpenClaw opera en DingTalk con tu identidad. Para usarlo en la empresa, repasa primero Endurecimiento de seguridad (1): control de acceso e identidad.

**Pensar que las tareas pendientes de grupo y el disco en la nube ya se pueden usar. ** El README marca ambos como Coming Soon. Lo que se puede usar ahora son las tareas pendientes personales, los documentos, el calendario, las hojas de IA, los informes diarios y el DING.

Siguiente sección ​

Con la mensajería IM de oficina conectada, puedes cambiar de línea: B1 Informe matutino diario para que Claw envíe cada día a una hora fija un resumen de noticias a tu IM.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.