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
| Proyecto | Contenido |
|---|---|
| Repositorio | https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector |
| Mantenedor | Cuenta 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ón | 0.8.27 (2026-10-20) |
| Estrellas | 2,128 (consulta de 2026-11-20) |
| Licencia | MIT |
| 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.
openclaw -vDeberí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.
npx -y @dingtalk-real-ai/dingtalk-connector installLa 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:
openclaw gateway restartEl 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.
- Abre la plataforma abierta de DingTalk https://open-dev.dingtalk.com/ y entra en "Desarrollo de aplicaciones".
- En la página de detalles de la aplicación, crea con un clic una aplicación de bot de OpenClaw.
- 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:
{
"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:
{
"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.