Canal WhatsApp do OpenClaw

O OpenClaw se conecta ao WhatsApp através da biblioteca Baileys — uma implementação de código aberto por engenharia reversa do protocolo multi-dispositivo do WhatsApp Web. Diferente da API oficial do WhatsApp Business (que requer aprovação da Meta e cobra por conversa), o Baileys se conecta diretamente emulando um dispositivo vinculado. A arquitetura é simples: seu celular permanece como dispositivo principal, e o Gateway atua como um dispositivo companheiro vinculado. As mensagens fluem pelos servidores do WhatsApp normalmente — o OpenClaw simplesmente intercepta as mensagens recebidas, processa-as com sua IA e envia as respostas de volta.

Um número de telefone dedicado é altamente recomendado. Embora você possa usar seu número pessoal, misturar conversas pessoais e do bot cria confusão no roteamento e pode incomodar seus contatos. Você precisa de um número de telefone real que possa receber SMS ou chamadas de voz para o registro inicial do WhatsApp. Uma vez registrado, o número só precisa permanecer ativo em um celular com o WhatsApp instalado.

{
  "channels": {
    "whatsapp": {
      "accounts": {
        "default": {
          "phone": "+15551234567"
        }
      }
    }
  }
}

Após configurar seu canal, você precisa vincular seu celular ao Gateway. Execute o comando de login e um código QR aparecerá no seu terminal. Escaneie-o com o WhatsApp no seu celular (Configurações → Aparelhos conectados → Conectar um aparelho). As credenciais são automaticamente salvas em ~/.openclaw/credentials/whatsapp/<accountId>/creds.json e persistem entre reinicializações. Um backup (creds.json.bak) é criado automaticamente para recuperação em caso de corrupção. Você só precisa escanear o código QR uma vez, a menos que a sessão expire ou seja revogada manualmente.

openclaw channels login whatsapp

As políticas de DM (Mensagens Diretas) controlam quem pode interagir com seu assistente de IA. O OpenClaw suporta quatro políticas: • pairing (padrão) — Novos contatos devem passar pelo fluxo de pareamento. Eles enviam uma mensagem, recebem um código de pareamento, e você aprova ou rejeita via CLI. Uma vez aprovados, podem conversar livremente. • allowlist — Apenas números de telefone explicitamente listados em allowFrom podem enviar mensagens ao bot. Todos os outros são silenciosamente ignorados. • open — Qualquer pessoa que envie mensagem para o número recebe uma resposta. Use com cautela em produção. • disabled — O tratamento de DM está completamente desativado. O bot não responderá a nenhuma mensagem direta.

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing",
      "allowFrom": ["+15551234567", "+15559876543"]
    }
  }
}

O OpenClaw pode participar de chats em grupo do WhatsApp. Por padrão, o suporte a grupos está desativado para evitar respostas indesejadas de IA em conversas compartilhadas. Quando ativado, o bot responde apenas quando mencionado pelo nome ou acionado por uma palavra-chave configurada. Você pode controlar quais grupos estão ativos e como o bot é ativado.

{
  "channels": {
    "whatsapp": {
      "groupPolicy": "allowlist",
      "groupActivation": "mention",
      "groupAllowList": ["group-jid-1", "group-jid-2"]
    }
  }
}

Você pode configurar se o OpenClaw envia confirmações de leitura (marcas azuis) ao processar uma mensagem. Por padrão, as confirmações de leitura são enviadas para manter uma conversa natural. Desativar as confirmações de leitura pode ser útil se você quer que o bot pareça menos "ativo" ou se está processando mensagens de forma assíncrona.

{
  "channels": {
    "whatsapp": {
      "sendReadReceipts": true
    }
  }
}

O OpenClaw pode reagir a mensagens recebidas com um emoji para confirmar o recebimento antes que a resposta da IA esteja pronta. Isso é útil porque respostas de IA podem levar vários segundos, e a reação informa ao remetente que sua mensagem foi recebida. Você pode configurar reações diferentes para mensagens diretas e chats em grupo, ou desativar o recurso completamente.

{
  "channels": {
    "whatsapp": {
      "ackReaction": {
        "emoji": "👀",
        "direct": true,
        "group": true
      }
    }
  }
}

O OpenClaw suporta envio de texto, imagens, documentos, áudio e vídeo pelo WhatsApp. Arquivos de mídia são tratados automaticamente — o Gateway faz upload para os servidores do WhatsApp e envia o tipo de mensagem apropriado. Para respostas longas de IA, o texto é automaticamente dividido em partes para ficar dentro dos limites de tamanho de mensagem do WhatsApp. Você pode configurar o tamanho das partes e o comportamento.

O WhatsApp aplica limites de taxa em dispositivos vinculados. Embora não haja limites oficiais publicados para contas pessoais, enviar muitas mensagens muito rapidamente pode provocar bloqueios temporários ou restrições de conta. O OpenClaw inclui limitação de taxa integrada para proteger sua conta. As configurações padrão são conservadoras e adequadas para a maioria dos casos de uso.

{
  "channels": {
    "whatsapp": {
      "textChunkLimit": 5,
      "mediaMaxMb": 50
    }
  }
}

Você pode estar se perguntando por que o OpenClaw usa o Baileys em vez da API oficial do WhatsApp Business (via Twilio, MessageBird, etc.). Aqui estão as razões: • Custo — A API Business cobra por conversa (aproximadamente $0,005–$0,08 por mensagem dependendo da região). Para uso pessoal ou de pequenas equipes, isso se acumula rapidamente. O Baileys é gratuito. • Aprovação — A API Business requer verificação da Meta, uma empresa registrada e aprovação de templates de mensagens. O Baileys funciona com qualquer conta pessoal do WhatsApp. • Flexibilidade — A API Business tem requisitos rigorosos de templates para mensagens enviadas e uma janela de conversa de 24 horas. O Baileys não tem tais restrições. • Auto-hospedado — Com o Baileys, tudo roda no seu servidor. Nenhum provedor de API de terceiros vê suas mensagens. O trade-off é a confiabilidade: a API Business tem suporte oficial, enquanto o Baileys depende de engenharia reversa e pode parar de funcionar se o WhatsApp mudar seu protocolo. Para a maioria dos casos de uso auto-hospedados, esse trade-off vale a pena.