Como Conectar WhatsApp ao OpenClaw

Imagine ter um assistente de IA disponível 24/7 no seu WhatsApp — organizando sua agenda, respondendo perguntas, lembrando de tarefas. Este tutorial mostra como fazer isso em menos de 10 minutos.

O Que Você Vai Conseguir

Após este tutorial, seu WhatsApp terá:

• Assistente de IA que responde suas mensagens
• Integração com calendário e lembretes
• Capacidade de ler e resumir emails
• Pesquisa na web em tempo real
• 🧠 Memória persistente (ele lembra de conversas anteriores)

Pré-requisitos

1. OpenClaw instalado - Guia de instalação
2. Número de WhatsApp dedicado (recomendado) ou seu número pessoal
3. 5 minutos do seu tempo

Atenção: Importante: Use um número secundário se possível. Embora seja seguro, ter um número dedicado evita conflitos com o WhatsApp Web.

Passo 1: Iniciar o OpenClaw

Se ainda não está rodando:

openclaw gateway start

Ou com Docker:

docker exec -it openclaw openclaw gateway start

Passo 2: Adicionar Canal WhatsApp

openclaw channel add whatsapp

Você verá algo assim:

 Conectando ao WhatsApp...

Escaneie o QR code abaixo com seu WhatsApp:

▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
█ ▄▄▄▄▄ █ ▀▀▄█▀█ ▄▄▄▄▄ █
█ █   █ █▀▄▀▀▄▄█ █   █ █
█ █▄▄▄█ █ ▄ ▄▀██ █▄▄▄█ █
...

Aguardando scan...

Passo 3: Escanear o QR Code

1. Abra o WhatsApp no seu celular
2. Vá em Configurações → Dispositivos Conectados
3. Toque em Conectar Dispositivo
4. Escaneie o QR code do terminal

Após alguns segundos:

Sim WhatsApp conectado com sucesso!
 Número: +55 11 9xxxx-xxxx
 Pronto para receber mensagens

Passo 4: Testar

Envie uma mensagem para você mesmo (ou peça para alguém enviar):

Olá! Você está funcionando?

O OpenClaw vai responder automaticamente!

Configurações Importantes

Definir Quem Pode Falar com o Bot

Por padrão, o OpenClaw responde a todas as mensagens. Para limitar:

Edite ~/.config/openclaw/config.yaml:

whatsapp:
  # Apenas números específicos
  allowedNumbers:
    - "+5511999999999"
    - "+5521888888888"
  
  # Ou bloquear números
  blockedNumbers:
    - "+5511000000000"
  
  # Ignorar grupos (recomendado no início)
  ignoreGroups: true

Personalizar Respostas

Crie um SOUL.md no seu workspace para definir a personalidade:

# Quem Sou Eu

Sou um assistente pessoal prestativo e direto.
Respondo em português do Brasil.
Sou informal mas profissional.
Uso emojis com moderação.

Configurar Horário de Funcionamento

Para não ser incomodado de madrugada:

whatsapp:
  quietHours:
    enabled: true
    start: "23:00"
    end: "07:00"
    timezone: "America/Sao_Paulo"
    message: "💤 Estou em modo silencioso. Responderei pela manhã!"

Casos de Uso Populares

1. Assistente de Agenda

Você: Quais são meus compromissos de amanhã?
Bot:  Amanhã, 1º de fevereiro:
     - 09:00 Reunião com equipe (Zoom)
     - 12:30 Almoço com cliente
     - 15:00 Call com fornecedor

2. Lembretes Rápidos

Você: Me lembra de ligar pro dentista às 14h
Bot: Sim Lembrete criado: "Ligar pro dentista" às 14:00

3. Resumo de Emails

Você: Algum email importante hoje?
Bot:  3 emails importantes:
     1. Fatura Nubank - vence dia 5
     2. Convite reunião - amanhã 10h
     3. Newsletter OpenClaw - novidades da semana

4. Pesquisas Rápidas

Você: Qual a cotação do dólar hoje?
Bot:  Dólar comercial: R$ 5,12
     Variação: +0,3% (12:45)

Troubleshooting

QR Code não aparece

# Limpar sessão anterior
rm -rf ~/.local/share/openclaw/whatsapp/
openclaw channel add whatsapp

WhatsApp desconecta frequentemente

Isso pode acontecer se:

• Você usa WhatsApp Web em outro lugar
• Conexão instável
• Sessão expirada

Solução: Reconecte e mantenha apenas o OpenClaw conectado.

Bot não responde

Verifique:

1. Gateway está rodando: openclaw gateway status
2. Logs: openclaw gateway logs
3. Chave de API válida: openclaw auth status

Mensagens duplicadas

Adicione rate limiting:

whatsapp:
  rateLimiting:
    enabled: true
    maxPerMinute: 10

Segurança e Privacidade

O que o OpenClaw acessa?

• ✅ Mensagens enviadas para o bot
• ✅ Mídias (fotos, áudios, documentos)
• Não Conversas de outros chats
• Não Sua lista de contatos
• Não Status/Stories

Onde ficam os dados?

Tudo local. Suas mensagens ficam no seu computador em:

• ~/.local/share/openclaw/whatsapp/ - sessão
• ~/.local/share/openclaw/messages/ - histórico (opcional)

Posso ser banido do WhatsApp?

O OpenClaw usa a biblioteca Baileys, que simula o WhatsApp Web. Riscos são baixos se você:

• Não enviar spam
• Não automatizar mensagens em massa
• Usar para fins pessoais

Próximos Passos

Agora que seu WhatsApp está conectado:

1. Configure memória persistente para o bot lembrar de conversas
2. Crie automações para receber resumos diários
3. Integre com seu calendário
4. Adicione Telegram como backup

Dúvidas? A comunidade está sempre pronta para ajudar no Discord!