Conectar OpenAI (GPT-4) ao WhatsApp com OpenClaw

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 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 — 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.
3. ✅ Conta na OpenAI com API key — Crie em 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, 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:

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. Se já estiver conectado, pule para o Passo 4.

Para verificar o status da conexão, execute:

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:

# 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 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.

Solução de Problemas Comuns

Para problemas não listados, veja o guia de troubleshooting ou os artigos do 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 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 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 — automatizações que funcionam desde o primeiro dia
• Skills personalizados — crie funções avançadas para casos de uso específicos
• Integrações disponíveis — conecte Google Sheets, Gmail, GitHub e mais
• Outros canais disponíveis — use o mesmo assistente no Telegram, Slack ou Discord
• Guia de segurança — proteja suas credenciais e configure permissões adequadas
• FAQ geral — perguntas frequentes sobre o OpenClaw