Canais e Modelos de IA no OpenClaw: Guia de Configuração

Dois dos primeiros choques que alguém tem ao começar com OpenClaw são: “por qual canal eu começo?” e “qual modelo de IA eu uso?”. Essas decisões afetam custo, velocidade, alcance e complexidade de setup. Este capítulo resolve as duas questões com dados práticos e um ponto de partida claro para o contexto brasileiro.

Canais Disponíveis no OpenClaw

Um canal é a ponte entre o mundo externo e o seu agente. Cada canal tem características diferentes de setup, custo e público.

Dominante no Brasil — 99% da população adulta com smartphone usa. Para qualquer negócio B2C ou MEI, o WhatsApp é o canal padrão sem discussão.

O OpenClaw suporta duas formas de conectar ao WhatsApp:

WhatsApp Business API (oficial)

Requer aprovação da Meta e um número dedicado
Custo: gratuito para as primeiras 1.000 conversas/mês iniciadas pelo cliente (desde 2024); conversas iniciadas pelo negócio têm custo por conversa (cerca de R$ 0,30-0,50 dependendo da categoria)
Vantagens: número verificado (selo verde), sem risco de ban, escala sem limite, suporte a botões e listas interativas
Setup: mais complexo — precisa de conta no Meta Business Manager, provedor BSP (Business Solution Provider) ou acesso direto à API via Cloud API

Adaptadores não-oficiais (número pessoal)

Conecta um número WhatsApp comum ao OpenClaw via automação do WhatsApp Web
Custo: zero (além do VPS)
Risco: violação dos termos de serviço do WhatsApp; conta pode ser banida
Uso: testes locais e automações pessoais de baixo volume

Para produção e atendimento de clientes reais, use sempre a API oficial. Para testar e aprender, o adaptador não-oficial funciona sem precisar de aprovação da Meta.

O Telegram tem uma Bot API pública, gratuita e sem aprovação necessária. Criar um bot leva literalmente 2 minutos via BotFather. Por isso, o Telegram é frequentemente usado para:

Projetos pessoais e prototipagem rápida
Comunidades técnicas e grupos de desenvolvedores
Ferramentas internas de equipe (onde todos já têm Telegram)
Automações que não precisam de alcance massivo

A limitação é clara: a penetração do Telegram no Brasil é muito menor que o WhatsApp. Para atendimento ao cliente de negócios brasileiros comuns, o Telegram não é o canal certo.

Slack

Para automações dentro de equipes corporativas. Se a sua empresa usa Slack como ferramenta principal de comunicação, faz sentido ter agentes lá — triagem de tickets, resumo de documentos, consulta de dados internos.

O setup requer uma conta de workspace Slack e criação de um app via API do Slack. Não é difícil, mas tem mais etapas que o Telegram.

Discord

Similar ao Telegram, mas com foco maior em comunidades de jogos, criadores e tech. Útil para projetos de comunidade, servidores temáticos e moderação automática.

HTTP/Webhook

O canal mais flexível — e o mais técnico. Você expõe um endpoint HTTP no OpenClaw e outro sistema chama esse endpoint quando quer interagir com o agente. Útil para:

Integrar o agente a um site ou app existente
Conectar via Zapier, n8n ou qualquer ferramenta de automação
Criar chatbots personalizados com interface própria

Modelos de IA: Qual Usar e Quanto Custa em Reais

O OpenClaw não tem inteligência própria — ele chama um modelo de IA externo (ou local) para processar cada mensagem. A escolha do modelo afeta qualidade, velocidade e custo.

Entendendo Tokens

Modelos de IA cobram por token — unidade de texto que equivale aproximadamente a 0,75 palavras em inglês ou menos em português (português tem palavras geralmente maiores). Uma mensagem curta tem 50-100 tokens. Uma conversa longa com histórico pode ter 2.000-5.000 tokens.

O custo é calculado pela soma de tokens de entrada (o que você manda para o modelo) mais tokens de saída (o que o modelo responde).

Comparativo de Modelos e Custos (fevereiro 2026)

Preços em dólar convertidos aproximadamente para real (considerando câmbio ~R$ 5,90 em março de 2026):

Modelo	Input (1M tokens)	Output (1M tokens)	Input em R$	Output em R$
Claude Haiku 3.5	US$ 0,80	US$ 4,00	R$ 4,72	R$ 23,60
GPT-4o mini	US$ 0,15	US$ 0,60	R$ 0,89	R$ 3,54
Claude Sonnet 3.5	US$ 3,00	US$ 15,00	R$ 17,70	R$ 88,50
GPT-4o	US$ 2,50	US$ 10,00	R$ 14,75	R$ 59,00
Ollama local	R$ 0	R$ 0	—	—

Na prática: uma conversa de atendimento típica (cliente manda uma pergunta, agente responde, mais uma troca) usa cerca de 500-1.000 tokens totais. Com Claude Haiku, isso custa menos de R$ 0,01. Com mil atendimentos por dia, o custo mensal de IA seria cerca de R$ 150-300.

Quando Usar Cada Modelo

Claude Haiku 3.5 — o ponto de partida ideal para a maioria dos casos brasileiros. Rápido (respostas em 1-2 segundos), barato, bom português. Executa bem tarefas de atendimento, consulta de dados, geração de texto simples e classificação. Para 90% dos casos de uso de MEI e pequenas empresas, Haiku é suficiente.

GPT-4o mini — custo ainda menor que Haiku, bom desempenho geral. Vale considerar se você quer minimizar custos ao máximo e já tem experiência com a API da OpenAI.

Claude Sonnet 3.5 — para tarefas que exigem raciocínio mais sofisticado: análise de documentos complexos, geração de código, fluxos de múltiplos passos com muitas variáveis. Custa mais, mas entrega mais.

GPT-4o — ponto forte em multimodalidade: análise de imagens, documentos visuais. Se o seu caso de uso envolve o cliente enviando fotos de produtos, notas fiscais ou comprovantes, GPT-4o processa isso nativamente.

Ollama (modelos locais) — custo zero de API, dados ficam no seu servidor. Os melhores modelos para uso no OpenClaw via Ollama são Llama 3.1 8B (rápido, bom para tarefas simples) e Llama 3.1 70B (qualidade próxima a GPT-4o mini, mas requer VPS com pelo menos 48 GB de RAM). Para privacidade de dados (LGPD) e eliminar variação cambial, vale considerar.

Na Prática: WhatsApp + Claude Haiku com Custo Mínimo

Este é o setup de menor atrito para começar no Brasil. WhatsApp Business API via Cloud API (direto com Meta, sem intermediário) + Claude Haiku.

1. Configure o WhatsApp Business API

Acesse developers.facebook.com e crie um app do tipo “Business”. Siga o fluxo para ativar a WhatsApp Business Platform. Você vai precisar de:

Conta no Meta Business Manager (gratuita)
Número de telefone dedicado (não pode ser um número já em uso no WhatsApp)
Verificação de negócio (para alguns recursos avançados)

A Cloud API da Meta permite até 1.000 conversas gratuitas por mês (iniciadas pelo cliente). Para começar a testar com clientes reais, isso é mais do que suficiente.

2. Obtenha o Access Token do WhatsApp

No painel do app, vá em WhatsApp → Configuração de API. Anote:

WHATSAPP_PHONE_NUMBER_ID: ID do seu número
WHATSAPP_ACCESS_TOKEN: token de acesso permanente

3. Configure o canal no OpenClaw

Em ~/.openclaw/config.yaml, adicione a seção de canal:

channels:
  - type: whatsapp
    name: meu-whatsapp
    phone_number_id: "SEU_PHONE_NUMBER_ID"
    access_token: "${WHATSAPP_ACCESS_TOKEN}"  # via variável de ambiente
    webhook_verify_token: "uma-string-aleatoria-sua"

Nunca coloque o token diretamente no arquivo de configuração — use variáveis de ambiente.

4. Configure o modelo

models:
  - name: haiku
    provider: anthropic
    model_id: claude-haiku-3-5-20241022
    api_key: "${ANTHROPIC_API_KEY}"

5. Defina as variáveis de ambiente

Crie um arquivo .env em ~/.openclaw/:

WHATSAPP_ACCESS_TOKEN=seu_token_aqui
ANTHROPIC_API_KEY=sk-ant-...

6. Registre o Webhook

O OpenClaw precisa receber as mensagens do WhatsApp via webhook. No painel Meta:

URL do Webhook: https://SEU_DOMINIO/webhook/whatsapp
Token de verificação: o mesmo webhook_verify_token do config

Se você está em um VPS, use o IP ou domínio do servidor. Se está rodando local, use ngrok para expor a porta localmente.

7. Inicie o OpenClaw

openclaw daemon restart
openclaw status

O status deve mostrar o canal WhatsApp como ativo. Mande uma mensagem para o número e veja a resposta do agente.

Para entender o que acontece por baixo desse fluxo e como adicionar ferramentas, o próximo capítulo cobre a configuração inicial completa. Você também pode explorar a página de canais para comparar todos os canais suportados com mais detalhes.

Baseado no “Automate Everything: The OpenClaw Handbook” por Kelly Claude (CC BY 4.0). Adaptado e expandido para o mercado brasileiro.