OpenClaw: Cuatro Problemas Críticos que los Desarrolladores Deben Conocer

Un escaneo reciente de issues abiertos en el repositorio de OpenClaw (366k estrellas) reveló cuatro errores y carencias de funcionalidades que están afectando activamente a despliegues en producción. Dos son errores que causan fallos silenciosos, y dos son funcionalidades faltantes que la comunidad ha estado solicitando. Aquí presentamos un desglose de cada uno.

1. Las imágenes enviadas a través de los canales nunca llegan al modelo

Cuando un usuario envía una imagen a través de Discord, Telegram, Feishu u OpenWebUI, el adaptador del canal elimina la imagen y solo pasa el texto al modelo. Los modelos con capacidad de visión responden como si no se hubiera proporcionado ninguna imagen o alucinan descripciones. La causa raíz es que la interfaz del adaptador de canal no propaga las URL de las imágenes ni los payloads en base64. La solución requiere extender la interfaz del adaptador para pasar estas representaciones de imagen. Varios issues rastrean esto, con #23452 como el resumen más claro.

2. WhatsApp y Telegram mueren permanentemente ante un breve fallo de DNS

La lógica de reconexión en los adaptadores de canal de WhatsApp y Telegram solo maneja desconexiones a mitad de sesión. Si ocurre un fallo de DNS durante la conexión inicial, el error escapa completamente del bucle de reintentos y el canal se cierra sin más intentos de reconexión. La puerta de enlace sigue funcionando, pero el canal está efectivamente muerto. Los usuarios reportan tener que ejecutar scripts externos de vigilancia para reiniciarlo. Ver issues #2198 y #13506.

3. No hay forma de ver qué está reteniendo el bloqueo de sesión

El almacén de sesiones utiliza archivos .jsonl.lock, que se bloquean regularmente debido a sesiones grandes, carga de cron, agentes paralelos o recargas de configuración. Cuando un bloqueo se atasca, todos los modelos fallan con session file locked (timeout 10000ms). La única recuperación es eliminar manualmente el archivo de bloqueo o reiniciar la puerta de enlace. El archivo de bloqueo ya contiene metadatos pid y createdAt, pero no hay un comando CLI para mostrarlos. Un comando propuesto openclaw locks leería esos metadatos y mostraría los waiters activos, dando a los operadores información procesable. Ver issues #31489 y #11950.

4. Sin coordinación paralela entre agentes

Las herramientas actuales session_spawn y send solo admiten delegación jerárquica: un agente pasa el trabajo hacia abajo y espera. No hay forma de que múltiples agentes colaboren en una tarea simultáneamente o compartan estado. El issue #43367 documenta usuarios que intentan ejecutar agentes de codificación en paralelo y se encuentran con sobrescrituras de configuración y contención de bloqueos además de la limitación de la arquitectura.

Estos cuatro elementos están abiertos para contribuciones y están impactando directamente configuraciones de producción. Si estás ejecutando OpenClaw en producción, revisa tus adaptadores de canal y la gestión de bloqueos de sesión, y considera contribuir con una solución.