Problemas de Confiabilidade do Gateway OpenClaw: Falhas Silenciosas Após 25 Dias de Uso Intenso

Padrão de Falha do Gateway

Um usuário do OpenClaw executando o sistema diariamente por aproximadamente 25 dias com mais de 18 tarefas cron e integração com o Telegram documentou um problema de confiabilidade recorrente. O gateway não falha completamente, mas entra em um estado 'zumbificado' onde o status mostra como 'em execução' enquanto toda a funcionalidade cessa. As tarefas cron ficam travadas indefinidamente, as mensagens falham ao serem entregues e nenhum alerta é gerado—incluindo a própria tarefa cron do monitor de integridade.

Problemas Específicos Encontrados

• Modelo inválido na configuração: O gateway aceitou configuração inválida no momento da escrita, depois falhou silenciosamente em cada turno do agente em vez de rejeitar imediatamente.
• Sessões travadas: Erros de conexão causaram interrupções de 15 minutos sem recuperação automática ou notificação.
• Bloqueios de arquivos de sessão mantidos para sempre: Chamadas de ferramentas travadas mantêm bloqueios de escrita indefinidamente, bloqueando TODAS as tarefas cron. A única solução é reinicialização completa.
• Gateway não inicia na inicialização: O LaunchAgent mostrou-se não confiável no macOS, exigindo uma solução alternativa de crontab @reboot sleep 30.
• Reinicializações redefinem o tempo das tarefas cron: As tarefas são executadas novamente ou perdem janelas após reinicialização. Aliases de modelo também quebram intermitentemente.
• Entrega de tarefas cron falha em sessões isoladas: A ferramenta de mensagem não tem permissões de entrega em sessões isoladas, exigindo reestruturação do payload.
• Incidente grave: Bloqueio de escrita de sessão mantido por 4,3 horas com 7 tarefas cron travadas em estado fantasma de 'execução'. Simultaneamente, uma atualização quebrou caminhos de plugins e o módulo de catálogo de modelos.

Correções Propostas

• Tempos limite de bloqueio de escrita (liberação forçada após 10 minutos)
• Loop de auto-integridade do gateway (verificar resolução de modelo, escritas de sessão, conectividade do canal a cada 5 minutos)
• Detecção de tarefas cron travadas (redefinir automaticamente tarefas 'em execução' por mais de 2x o tempo limite)
• Reinicializações seguras para atualizações (npm update deve acionar reinicialização graciosa)
• Comando openclaw cron reset <id> para destravar tarefas sem reinicialização completa

Detalhes do Ambiente

macOS arm64, Node 22, 18 tarefas cron, integração com Telegram, LaunchAgent. Versões 2026.2.24 → 2026.2.25.