---
title: "Bot WhatsApp com IA — Guia Completo OpenClaw"
url: "https://openclaw.ia.br/canais/whatsapp/"
markdown_url: "https://openclaw.ia.br/canais/whatsapp.MD"
description: "Crie seu bot de WhatsApp com inteligência artificial em 2 minutos. Use seu próprio número, processe áudio, imagens e documentos. Tutorial passo a passo."
date: ""
author: ""
---

# Bot WhatsApp com IA — Guia Completo OpenClaw

Crie seu bot de WhatsApp com inteligência artificial em 2 minutos. Use seu próprio número, processe áudio, imagens e documentos. Tutorial passo a passo.


# OpenClaw no WhatsApp

O canal mais popular. Configure em **2 minutos** usando seu próprio número.

---

##  Configuração Rápida

### 1. Iniciar conexão

```bash
openclaw channel add whatsapp
```

### 2. Escanear QR Code

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

### 3. Testar

Mande "Olá!" para si mesmo (ou qualquer contato). Se responder, funcionou! 

---

##  Como Funciona

OpenClaw conecta via **WhatsApp Web**. Seu número continua funcionando normalmente — você só ganha um assistente inteligente.

```
Você → WhatsApp → OpenClaw → Claude/GPT → WhatsApp → Você
```

**Nenhum servidor externo.** Tudo roda no seu computador.

---

##  O Que Você Pode Fazer

### Texto
Digite normalmente. O assistente entende e responde.

###  Áudio
Mande voice note. OpenClaw **transcreve automaticamente** e processa.

> "Manda áudio pedindo para resumir aquele PDF"

###  Imagens
Envie fotos, screenshots, documentos. O assistente **analisa o conteúdo**.

> "O que tem nessa imagem?"
> "Traduz esse menu"

###  Arquivos
PDFs, documentos Word, planilhas. OpenClaw extrai e processa o texto.

> "Resume esse contrato"
> "Quais são os pontos principais?"

---

##  Segurança

Por padrão, **apenas você** pode comandar o bot:

```yaml
# No seu config.yaml
channels:
  whatsapp:
    allowFrom:
      - "5511999998888"  # seu número
```

### Adicionar mais pessoas

```yaml
channels:
  whatsapp:
    allowFrom:
      - "5511999998888"  # você
      - "5511888887777"  # colega
```

---

##  Usar em Grupos

### Só quando mencionado

```yaml
channels:
  whatsapp:
    groups:
      mode: "mentions"
```

O bot só responde quando você menciona ele ou responde a uma mensagem dele.

### Sempre ativo

```yaml
channels:
  whatsapp:
    groups:
      mode: "always"
```

⚠ Cuidado: pode gerar muitas mensagens.

---

##  Dicas de Uso

1. **Use áudio** — Mais rápido que digitar longas mensagens
2. **Encaminhe mensagens** — "O que você acha disso?"
3. **Mande screenshots** — "Me ajuda a preencher esse formulário"
4. **Agrupe pedidos** — "Faça A, B e C" ao invés de 3 mensagens separadas

---

## ⚠ Limitações

| Limitação | Solução |
|-----------|---------|
| Desconecta após ~14 dias | Reconecte com `openclaw channel reconnect whatsapp` |
| Rate limit (muitas mensagens) | Evite enviar spam |
| Alguns recursos de grupo | Use Telegram para grupos complexos |

---

##  Troubleshooting

### Desconectou

```bash
openclaw channel reconnect whatsapp
```

### QR code não aparece

```bash
openclaw channel remove whatsapp
openclaw channel add whatsapp
```

### Bot não responde

```bash
# Verificar status
openclaw gateway status

# Ver logs
openclaw gateway logs -f
```

### Mensagens duplicadas

Verifique se não há outra instância do OpenClaw rodando:

```bash
ps aux | grep openclaw
```

---

---

##  O Que Fazer Agora?

Seu WhatsApp está conectado! Escolha seu próximo passo:

<div class="next-steps-grid" style="display: grid; grid-template-columns: repeat(auto-fit, minmax(250px, 1fr)); gap: 1rem; margin: 1.5rem 0;">

###  Personalizar Seu Assistente
Dê personalidade e contexto ao seu bot:
- [Configurar SOUL.md](/tutoriais/personalizar-soul/) — Tom, estilo, personalidade
- [Configurar Memória](/tutoriais/configurar-memoria/) — Contexto persistente

###  Expandir Funcionalidades
Adicione superpoderes com skills:
- [Criar Skills](/skills/) — Catálogo de extensões
- [Receitas Prontas](/receitas/) — Automações para copiar

###  Tutoriais Práticos
Aprenda com exemplos reais:
- [Primeiro Bot](/tutoriais/primeiro-bot/) — Passo a passo completo
- [Automação de Email](/tutoriais/automacao-email/) — Integre Gmail/Outlook
- [Multi-Agente](/tutoriais/multi-agente/) — Orquestre vários assistentes

</div>

---

##  Outros Canais

Quer usar em outras plataformas também?

| Canal | Vantagem | Guia |
|-------|----------|------|
| **Telegram** | Bot separado, inline keyboards | [Configurar →](/canais/telegram/) |
| **Discord** | Ideal para comunidades | [Configurar →](/integracoes/discord/) |
| **Slack** | Integração empresarial | [Configurar →](/integracoes/slack/) |
| **Signal** | Máxima privacidade | [Configurar →](/canais/signal/) |

>  **Dica:** Muitos usuários conectam WhatsApp + Telegram. O WhatsApp para uso pessoal rápido, Telegram para grupos e automações mais complexas.

---

##  Pronto para Começar?

<div class="cta-box" style="background: linear-gradient(135deg, #25D366 0%, #128C7E 100%); color: white; padding: 2rem; border-radius: 1rem; text-align: center; margin: 2rem 0;">

**Seu assistente de IA está a uma mensagem de distância.**

Mande "Olá!" para seu número e veja a mágica acontecer.

[Ver Todos os Tutoriais →](/tutoriais/) | [Explorar Skills →](/skills/)

</div>

---

##  Artigos Relacionados

- [Automação WhatsApp com IA: Guia Completo](/blog/automacao-whatsapp-ia-guia-completo/)
- [20 Casos de Uso Reais do OpenClaw](/blog/20-casos-uso-reais-openclaw/)
- [Quanto Custa Usar o OpenClaw?](/blog/quanto-custa-openclaw-analise-tokens/)
- [Guia de Segurança 2026](/blog/guia-seguranca-openclaw-2026/)