---
title: "Como Conectar WhatsApp ao OpenClaw: Guia Definitivo 2026"
url: "https://openclaw.ia.br/blog/como-conectar-whatsapp-openclaw/"
markdown_url: "https://openclaw.ia.br/blog/como-conectar-whatsapp-openclaw.MD"
description: "Tutorial completo para integrar seu WhatsApp com OpenClaw. Aprenda a criar seu assistente de IA pessoal no WhatsApp em minutos."
date: "2026-01-31"
author: "Pinnochio"
---

# Como Conectar WhatsApp ao OpenClaw: Guia Definitivo 2026

Tutorial completo para integrar seu WhatsApp com OpenClaw. Aprenda a criar seu assistente de IA pessoal no WhatsApp em minutos.


# 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](/instalacao/)
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:

```bash
openclaw gateway start
```

Ou com Docker:

```bash
docker exec -it openclaw openclaw gateway start
```

## Passo 2: Adicionar Canal WhatsApp

```bash
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`:

```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:

```markdown
# 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:

```yaml
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

```bash
# 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:

```yaml
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](https://github.com/WhiskeySockets/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](/tutoriais/configurar-memoria/) para o bot lembrar de conversas
2. [Crie automações](/receitas/briefing-matinal/) para receber resumos diários
3. [Integre com seu calendário](/integracoes/google-calendar/)
4. [Adicione Telegram](/canais/telegram/) como backup

---

**Dúvidas?** A comunidade está sempre pronta para ajudar no [Discord](https://discord.com/invite/clawd)!