WhatsApp no OpenClaw: Economize 2 Horas Atualizando para o 5.7 Primeiro

Configurando o WhatsApp no OpenClaw pela primeira vez? Aqui está o conhecimento tribal que falta na documentação, direto de um usuário que acabou de ajudar um amigo com isso.

Fatos Chave da Configuração

• O OpenClaw usa a Baileys, uma biblioteca não oficial do WhatsApp Web — não a API Business oficial. Seu número pessoal do WhatsApp se torna o bot, e não pode ser usado em um número já ativo no WhatsApp Web no seu celular. O pareamento ocorre via QR code durante a configuração inicial.
• O gateway deve ficar ativo 24/7. Se a conexão cair, você precisa emparelhar novamente. Colocar o laptop para dormir vai quebrar a conexão — use um VPS ou uma máquina sempre ligada.

Bugs Críticos Corrigidos na 5.7

Se você estiver na 5.6 ou anterior, encontrará vários bugs específicos do WhatsApp. Atualize para a 5.7 antes de prosseguir:

• Chats fantasmas (corrigido na 5.7, #67378): Mensagens proativas para números de telefone criavam chats fantasmas apenas para o remetente, que ninguém recebia.
• Clientes TUI desatualizados (corrigido na 5.7): Na 5.5, eles degradavam o loop de eventos do gateway, diminuindo TODAS as respostas — não apenas do WhatsApp.
• Envio duplicado de mídia com legenda (corrigido na 5.7, #78770): Antes da correção, os destinatários recebiam primeiro uma mensagem vazia e depois a foto real.

Conclusão: Atualize para o OpenClaw 5.7+ antes de configurar o WhatsApp. Versões anteriores têm vários bugs específicos do WhatsApp que farão você pensar que sua configuração está quebrada. Se você quer controle total, o OpenClaw funciona bem na 5.7+. Se preferir menos complicação, o BetterClaw configura o WhatsApp em minutos sem a dança de pareamento do Baileys.