OpenClaw: Quatro Questões Críticas que Desenvolvedores Precisam Saber

Uma varredura recente de issues abertas no repositório OpenClaw (366k estrelas) revelou quatro bugs e lacunas de funcionalidades que estão afetando ativamente implantações em produção. Dois são bugs que causam falhas silenciosas, e dois são funcionalidades ausentes que a comunidade vem solicitando. Aqui está um detalhamento de cada um.

1. Imagens enviadas pelos canais nunca chegam ao modelo

Quando um usuário envia uma imagem via Discord, Telegram, Feishu ou OpenWebUI, o adaptador do canal remove a imagem e passa apenas o texto para o modelo. Modelos com capacidade de visão ou respondem como se nenhuma imagem tivesse sido fornecida ou alucinam descrições. A causa raiz é que a interface do adaptador de canal não propaga URLs de imagem ou payloads base64. A correção requer estender a interface do adaptador para passar essas representações de imagem. Várias issues rastreiam isso, com #23452 sendo o resumo mais claro.

2. WhatsApp e Telegram morrem permanentemente em uma breve falha de DNS

A lógica de reconexão nos adaptadores de canal do WhatsApp e Telegram só lida com desconexões no meio da sessão. Se uma falha de DNS ocorrer durante a conexão inicial, o erro escapa do loop de tentativas completamente, e o canal sai sem novas tentativas de reconexão. O gateway continua rodando, mas o canal está efetivamente morto. Usuários relatam que executam scripts de monitoramento externos para reiniciá-lo. Veja as issues #2198 e #13506.

3. Não há como ver o que está segurando o bloqueio de sessão

O armazenamento de sessão usa arquivos .jsonl.lock, que ficam travados regularmente devido a sessões grandes, carga de cron, agentes paralelos ou recarregamentos de configuração. Quando um bloqueio fica travado, todos os modelos falham com session file locked (timeout 10000ms). A única recuperação é matar manualmente o arquivo de bloqueio ou reiniciar o gateway. O arquivo de bloqueio já contém metadados pid e createdAt, mas não há um comando CLI para exibi-los. Um comando proposto openclaw locks leria esses metadados e mostraria os waiters ativos, dando aos operadores informações acionáveis. Veja as issues #31489 e #11950.

4. Nenhuma coordenação paralela entre agentes

As ferramentas atuais session_spawn e send só suportam delegação hierárquica — um agente passa o trabalho para baixo e espera. Não há como múltiplos agentes colaborarem em uma tarefa simultaneamente ou compartilharem estado. A issue #43367 documenta usuários tentando executar agentes de codificação paralelos e encontrando sobrescrita de configuração e contenção de bloqueio além da limitação da arquitetura.

Estes quatro itens estão abertos para contribuição e estão afetando diretamente configurações de produção. Se você está executando OpenClaw em produção, verifique seus adaptadores de canal e gerenciamento de bloqueio de sessão — e considere contribuir com uma correção.