---
title: "Conectar OpenAI (GPT-4) ao WhatsApp com OpenClaw"
url: "https://openclaw.ia.br/conectar/openai-whatsapp/"
markdown_url: "https://openclaw.ia.br/conectar/openai-whatsapp.MD"
description: "Guia passo a passo para conectar OpenAI (GPT-4) ao WhatsApp via OpenClaw. Use GPT-4 como modelo de linguagem no OpenClaw direto do WhatsApp."
date: "2026-02-13"
author: ""
---

# Conectar OpenAI (GPT-4) ao WhatsApp com OpenClaw

Guia passo a passo para conectar OpenAI (GPT-4) ao WhatsApp via OpenClaw. Use GPT-4 como modelo de linguagem no OpenClaw direto do WhatsApp.


## OpenAI (GPT-4) + WhatsApp: Automatize IA pelo Chat

Imagine ter o poder do GPT-4 disponível direto no WhatsApp, sem precisar abrir nenhum app adicional. Com o OpenClaw, você integra a API da OpenAI ao mensageiro mais popular do Brasil — usado por mais de 197 milhões de brasileiros — e passa a usar inteligência artificial por mensagem de texto, da mesma forma que conversa com amigos e colegas.

Essa combinação é especialmente útil para profissionais que vivem no WhatsApp e querem aproveitar IA no dia a dia sem mudar seus hábitos. Você pode gerar textos, traduzir documentos, escrever código, fazer análises e muito mais — tudo dentro do mesmo chat que já usa para trabalho.

**O que você consegue fazer:**

- **Conversar** — via mensagem no WhatsApp, com contexto persistente entre mensagens
- **Analisar textos** — cole um trecho e peça resumo, crítica ou reformulação
- **Gerar conteúdo** — e-mails, posts, relatórios e propostas sob demanda
- **Traduzir** — qualquer idioma, com opção de manter tom formal ou informal
- **Programar** — peça código, explique erros ou peça revisão de scripts

Veja o [glossário de termos de IA](/glossario/) se quiser entender melhor conceitos como API, token e modelo de linguagem antes de começar.

## Pré-requisitos

Antes de começar, você precisa:

1. ✅ **[OpenClaw instalado](/instalacao/)** — leva 5 minutos
2. ✅ **WhatsApp conectado** — Certifique-se de que o WhatsApp está conectado ao OpenClaw via QR code. Veja o [guia de conexão WhatsApp](/canais/whatsapp/).
3. ✅ **Conta na OpenAI com API key** — Crie em [platform.openai.com](https://platform.openai.com) e gere uma chave de API com créditos disponíveis
4. ✅ **Modelo GPT-4 habilitado** — Acesso ao GPT-4 requer conta com faturamento ativo na OpenAI

## Configuração Passo a Passo

### Passo 1: Obter sua API Key da OpenAI

Acesse [platform.openai.com/api-keys](https://platform.openai.com/api-keys), clique em **Create new secret key** e copie a chave gerada. Guarde em local seguro — ela não será exibida novamente.

Defina também um limite de gastos mensais em **Settings > Limits** para evitar cobranças inesperadas.

### Passo 2: Configurar a Integração no OpenClaw

Abra o arquivo `config.yaml` do seu OpenClaw e adicione:

```yaml
llm:
  provider: openai
  model: gpt-4o
  api_key: sk-sua-chave-aqui
  max_tokens: 2048
  temperature: 0.7
```

Salve o arquivo e reinicie o gateway com `openclaw gateway restart`.

### Passo 3: Conectar ao WhatsApp

Certifique-se de que o WhatsApp está conectado ao OpenClaw via QR code. Veja o [guia de conexão WhatsApp](/canais/whatsapp/). Se já estiver conectado, pule para o Passo 4.

Para verificar o status da conexão, execute:

```bash
openclaw status
```

### Passo 4: Testar a Conexão

Abra o WhatsApp e envie para o OpenClaw:

> "Teste a conexão com OpenAI GPT-4"

Se tudo estiver correto, o OpenClaw responde confirmando que a integração está ativa e exibe o modelo em uso.

### Passo 5: Configurar Automações no Soul.md

No arquivo `soul.md` do seu workspace, defina como o assistente deve se comportar:

```yaml
# Exemplo no soul.md
Você é um assistente profissional chamado Claw.
Use GPT-4 para todas as respostas.
Responda sempre em português brasileiro.
Quando receber uma tarefa:
- Confirme o entendimento antes de executar
- Seja conciso mas completo
- Sugira próximos passos quando relevante
```

Consulte o [guia de configuração de soul.md](/guias/) para opções avançadas de personalização.

## Exemplos de Uso

### Exemplo 1: Redação Profissional

Envie no WhatsApp:

> "Escreva um e-mail formal pedindo extensão de prazo para entrega de um projeto. O cliente se chama João e o prazo original era amanhã. Quero pedir mais 3 dias úteis."

O GPT-4 gera um e-mail pronto para envio, com tom adequado e justificativa profissional.

### Exemplo 2: Análise de Código

Envie no WhatsApp:

> "Analise este código Python e me diga o que está errado:
> def calcular_media(numeros):
>     return sum(numeros) / len(numeros)"

O OpenClaw processa via GPT-4 e retorna a análise: a função não trata listas vazias (divisão por zero) e pode lançar exceção com entradas não numéricas — com sugestão de correção.

### Exemplo 3: Tradução com Contexto

Envie no WhatsApp:

> "Traduza para inglês formal, para uso em contrato: 'O prestador se compromete a entregar os serviços no prazo estipulado, sob pena de multa contratual.'"

### Exemplo 4: Relatório Rápido

Envie no WhatsApp:

> "Me dá um resumo do que o GPT-4 pode fazer, em 5 bullet points, para apresentar para meu chefe"

O OpenClaw gera um relatório consolidado, pronto para copiar e colar.

## Dicas e Boas Práticas

- **Seja específico nos pedidos**: Quanto mais contexto você fornecer, melhor a resposta do GPT-4. Em vez de "escreva um texto", diga "escreva um texto de 200 palavras sobre X para público Y com tom Z".
- **Use o contexto de conversa**: O OpenClaw mantém histórico da sessão. Você pode dizer "melhore o parágrafo 2 do texto anterior" sem precisar repetir tudo.
- **Defina um papel**: Comece suas sessões com "Você é um especialista em finanças" ou "Aja como revisor de textos" para respostas mais precisas.
- **Controle os custos**: GPT-4 consome mais tokens que GPT-3.5. Use `gpt-4o-mini` para tarefas simples e reserve GPT-4 para análises complexas.
- **Combine com integrações**: Conecte Google Sheets ao WhatsApp para analisar planilhas com IA. Veja o guia de [integrações disponíveis](/integracoes/).

## Solução de Problemas Comuns

| Problema | Solução |
|----------|---------|
| "Integração não responde" | Verifique a API key no `config.yaml` e confirme que tem créditos na conta OpenAI |
| "Erro de autenticação" | Gere uma nova API key em platform.openai.com e atualize o config.yaml |
| "Mensagens não chegam no WhatsApp" | Confirme que o WhatsApp está conectado com `openclaw status` |
| "Respostas muito lentas" | GPT-4 pode demorar 5-15 segundos. Use `gpt-4o` para melhor velocidade |
| "Erro: insufficient_quota" | Adicione créditos ou método de pagamento na conta OpenAI |
| "Respostas cortadas no meio" | Aumente `max_tokens` no config.yaml |

Para problemas não listados, veja o [guia de troubleshooting](/troubleshooting/) ou os [artigos do blog](/blog/) sobre configurações avançadas.

## FAQ

**Qual a diferença entre GPT-4 e GPT-4o?**
GPT-4o é a versão otimizada ("o" de "omni"), mais rápida e com custo menor que o GPT-4 original, mantendo qualidade similar para a maioria das tarefas. Para uso no WhatsApp, `gpt-4o` é geralmente a melhor escolha.

**O OpenClaw armazena minhas conversas?**
As conversas ficam no seu dispositivo local (arquivo de memória no workspace). Apenas o conteúdo enviado para a API da OpenAI passa pelos servidores deles. Veja as [políticas de privacidade da OpenAI](https://openai.com/privacy) para detalhes.

**Posso usar GPT-4 em grupos do WhatsApp?**
Sim. Configure o OpenClaw para responder quando mencionado com @nome-do-bot nos grupos. Veja o [guia de canais](/canais/) para configuração.

**Qual o custo médio por mensagem?**
Uma conversa típica de 10 mensagens com GPT-4o custa em torno de US$ 0,01 a US$ 0,05, dependendo do tamanho das mensagens. Use o painel da OpenAI para monitorar gastos.

**Posso trocar de modelo sem reconfigurar tudo?**
Sim. Basta alterar o campo `model` no `config.yaml` e reiniciar o gateway. As automações e o soul.md continuam funcionando normalmente.

## Próximos Passos

- [Receitas prontas com IA](/receitas/) — automatizações que funcionam desde o primeiro dia
- [Skills personalizados](/skills/) — crie funções avançadas para casos de uso específicos
- [Integrações disponíveis](/integracoes/) — conecte Google Sheets, Gmail, GitHub e mais
- [Outros canais disponíveis](/canais/) — use o mesmo assistente no Telegram, Slack ou Discord
- [Guia de segurança](/seguranca/) — proteja suas credenciais e configure permissões adequadas
- [FAQ geral](/faq/) — perguntas frequentes sobre o OpenClaw