Problemas de Confiabilidad de la Pasarela OpenClaw: Fallos Silenciosos Después de 25 Días de Uso Intenso

Patrón de Fallo de la Puerta de Enlace

Un usuario de OpenClaw que ejecuta el sistema diariamente durante aproximadamente 25 días con más de 18 trabajos cron e integración de Telegram ha documentado un problema de fiabilidad recurrente. La puerta de enlace no se bloquea por completo, sino que entra en un estado 'zombificado' donde el estado se muestra como 'en ejecución' mientras toda la funcionalidad cesa. Los trabajos cron se atascan indefinidamente, los mensajes no se entregan y no se generan alertas, incluido el propio trabajo cron del monitor de salud.

Problemas Específicos Encontrados

• Modelo inválido en la configuración: La puerta de enlace aceptó una configuración inválida al escribir, luego falló silenciosamente en cada turno del agente en lugar de rechazarla inmediatamente.
• Bloqueos de sesión: Los errores de conexión causaron apagones de 15 minutos sin recuperación automática ni notificación.
• Bloqueos de archivos de sesión retenidos para siempre: Las llamadas de herramientas bloqueadas mantienen bloqueos de escritura indefinidamente, bloqueando TODOS los trabajos cron. La única solución es un reinicio completo.
• La puerta de enlace no se inicia al arrancar: LaunchAgent resultó poco fiable en macOS, requiriendo una solución alternativa con @reboot sleep 30 en crontab.
• Los reinicios restablecen el tiempo de cron: Los trabajos se vuelven a disparar o pierden ventanas después del reinicio. Los alias de modelo también se rompen intermitentemente.
• La entrega de cron falla en sesiones aisladas: La herramienta de mensajes carece de permisos de entrega en sesiones aisladas, requiriendo reestructuración de la carga útil.
• Incidente grave: Bloqueo de escritura de sesión retenido durante 4.3 horas con 7 trabajos cron atascados en estado fantasma de 'ejecución'. Simultáneamente, una actualización rompió las rutas de los complementos y el módulo del catálogo de modelos.

Soluciones Propuestas

• Límites de tiempo para bloqueos de escritura (liberación forzada después de 10 minutos)
• Bucle de autosalud de la puerta de enlace (verificar resolución de modelos, escrituras de sesión, conectividad del canal cada 5 minutos)
• Detección de cron atascado (restablecimiento automático de trabajos 'en ejecución' durante más de 2 veces el tiempo de espera)
• Reinicios seguros para actualizaciones (npm update debería activar un reinicio ordenado)
• Comando openclaw cron reset <id> para desatascar trabajos sin reinicio completo

Detalles del Entorno

macOS arm64, Node 22, 18 trabajos cron, integración de Telegram, LaunchAgent. Versiones 2026.2.24 → 2026.2.25.