Design do Stack de Automação: Como Montar Seu Sistema OpenClaw

Existe uma diferença entre ter automações e ter um sistema de automação. Automações isoladas funcionam até quebrar — e quando quebram, você não sabe por quê, nem onde, nem desde quando. Um sistema é diferente: tem estrutura, tem documentação, tem monitoramento, e quando algo quebra, você recebe um aviso antes do cliente perceber.

Este capítulo cobre como sair do primeiro estado e chegar ao segundo.

O Princípio “Desenha Antes de Codificar”

A tentação é abrir o OpenClaw e começar a criar nós. Resista.

Antes de qualquer configuração, desenhe o fluxo em papel ou em uma ferramenta simples como Excalidraw, FigJam ou até no bloco de notas. O exercício de desenhar força você a responder perguntas que a implementação vai cobrar mais tarde:

Qual é o gatilho? O que inicia esse fluxo?
Quais dados entram? De onde vêm?
O que pode dar errado em cada passo?
O que acontece quando dá errado?
Qual é o resultado esperado? Como você sabe que funcionou?

Um diagrama de caixas e setas de 10 minutos poupa horas de debugging depois. Especialmente para fluxos com condicionais — “se o pagamento confirmou, vai para A; se não confirmou em 2 horas, vai para B” — visualizar a lógica antes de implementar evita erros de lógica difíceis de encontrar depois.

Formatos úteis para documentar:

[Gatilho] → [Passo 1] → [Condição] → [Passo 2A] ou [Passo 2B]
                                            ↓               ↓
                                       [Resultado A]  [Resultado B]

Não precisa ser bonito. Precisa ser claro.

Decisão 1: Local vs VPS

A primeira decisão de infraestrutura: onde o OpenClaw vai rodar.

Local (seu computador ou Raspberry Pi):

Custo: zero (hardware que você já tem)
Limitações: só funciona quando o computador está ligado e conectado à internet. Se travar, dormir ou reiniciar, as automações param. Inadequado para qualquer coisa que precise funcionar 24/7 ou fora do horário comercial.
Quando faz sentido: experimentação, desenvolvimento, automações que só precisam rodar quando você está na frente do computador.

VPS (servidor virtual privado):

Custo: R$ 30-120/mês dependendo do provedor e plano
Vantagens: fica ligado 24/7, IP fixo, sem dependência do seu hardware pessoal
Quando é necessário: qualquer automação que precise responder mensagens fora do horário comercial, ou que precise rodar em horários específicos via cron

Para o contexto brasileiro, o ponto de virada é claro: se você está automatizando atendimento no WhatsApp, você precisa de VPS. Cliente não avisa quando vai mandar mensagem.

Decisão 2: Qual VPS

Para OpenClaw no Brasil, o cenário é o seguinte:

Hostinger KVM2 (R$ 43,99/mês no ciclo promocional, renovação de R$ 77,99/mês): 2 vCPU, 8GB RAM, 100GB NVMe, 8TB tráfego. É o ponto de entrada mais razoável para OpenClaw em produção. Datacenter em São Paulo (SP) = latência baixa para usuários brasileiros. É a opção que a maioria dos membros do OpenClaw Club Brasil usa como primeiro servidor.

Hostinger KVM4: 4 vCPU, 16GB RAM. Necessário se você for rodar modelos Ollama localmente no servidor (ver próxima seção).

DigitalOcean / Linode / Vultr: provedores internacionais. Sem datacenter no Brasil — latência maior, mas serviço estável e boa documentação. Preço similar ao Hostinger em dólares (R$ 40-80/mês com câmbio atual).

AWS / GCP / Azure: overkill para MEI e freelancer. Custo variável, curva de aprendizado alta, cobrança por uso que pode surpreender. Faz sentido se você já usa essa infraestrutura para outros projetos.

Para maioria dos casos de uso cobertos neste guia, Hostinger KVM2 é suficiente. Veja mais detalhes técnicos na seção de VPS.

Decisão 3: Qual Modelo de IA

O OpenClaw orquestra agentes, e cada agente pode usar um modelo diferente. A escolha do modelo envolve três variáveis: velocidade, qualidade e custo.

Claude Haiku (Anthropic):

Velocidade: muito rápido (< 1 segundo para respostas curtas)
Qualidade: boa para tarefas simples e triagem
Custo: ~$0,80 por milhão de tokens de entrada
Ideal para: triagem de mensagens, classificação de intenção, respostas a perguntas frequentes

Claude Sonnet (Anthropic):

Velocidade: rápido (2-4 segundos)
Qualidade: alta para a maioria das tarefas
Custo: ~$3 por milhão de tokens de entrada
Ideal para: geração de conteúdo, briefings, análises, fluxos que exigem raciocínio

Ollama (modelos locais):

Velocidade: variável — depende do hardware do servidor
Qualidade: variável — modelos como Llama 3, Mistral e Qwen2.5 chegam perto do Haiku para tarefas simples
Custo: zero por token (você paga só pelo servidor)
Ideal para: privacidade de dados (dados não saem do seu servidor), volume alto onde o custo por token se acumula, ou contextos onde dados sensíveis não podem ir para APIs externas

Regra prática para o Brasil: para MEI e pequenos negócios com volume moderado (centenas de mensagens por dia, não milhares), Haiku para triagem e Sonnet para conteúdo é a combinação mais econômica. O custo mensal fica bem abaixo de R$ 100 para a maioria dos casos.

Se você lida com dados sensíveis — informações de saúde, dados financeiros de clientes, conversa confidencial — considere seriamente Ollama no seu próprio servidor. LGPD (Lei Geral de Proteção de Dados) é realidade, e enviar dados de clientes para APIs externas cria obrigações que muitos MEIs não percebem que estão assumindo.

Skills e o System Prompt

O OpenClaw organiza skills em 3 níveis:

Workspace (~/.openclaw/workspace/skills/) — suas skills locais, prioridade máxima
Managed — instaladas do ClawHub via openclaw skills install
Bundled — incluídas na instalação, prioridade mais baixa

Cada skill consome ~97 caracteres no system prompt. Com 20 skills ativas, são ~2.000 tokens reservados — considere isso na escolha do modelo.

Decisão 4: Quais Canais

A regra de ouro: comece com um canal e domine-o antes de adicionar outro.

Para o Brasil, a ordem natural é:

WhatsApp: onde seus clientes já estão. Onde a comunicação de negócios já acontece. Tem a maior base instalada do país. Comece aqui.
Email: mais formal, adequado para notificações de sistema, boletos, documentos. Complementa o WhatsApp.
Telegram: menor base no Brasil mas crescendo; melhor API para automações complexas; zero risco de banimento por uso legítimo (diferente do WhatsApp).
Instagram DM: se seu negócio tem presença no Instagram e recebe perguntas por lá.
SMS: para confirmações críticas quando WhatsApp não está disponível.

Adicionar canais aumenta a complexidade exponencialmente, não linearmente. Dois canais não é duas vezes mais trabalho — é quatro vezes, porque você precisa manter consistência entre eles, tratar usuários que chegam por canais diferentes como a mesma pessoa, e monitorar cada canal separadamente.

Convenções de Nomenclatura

Nomear fluxos, agentes e variáveis de forma consistente parece burocracia até o dia que você tem 30 fluxos e não sabe qual é qual.

Padrão recomendado para fluxos:

{canal}-{ação}-{objeto}

Exemplos:
whatsapp-atendimento-inicial
whatsapp-cobrança-pix
email-notificação-pedido
cron-lembrete-das
cron-relatorio-semanal

Para variáveis de configuração:

CANAL_CHAVE       → ex: WA_PHONE_NUMBER, EMAIL_REMETENTE
INTEGRACAO_CHAVE  → ex: MP_API_KEY, EFIPAY_CLIENT_ID
NEGOCIO_DADO      → ex: MEI_NOME, MEI_CNPJ, MEI_VALOR_DAS

Se você vem de uma versão anterior e ainda tem variáveis CLAWDBOT_* ou MOLTBOT_*, troque por OPENCLAW_* — o rebrand foi concluído na v2026.3.22.

Isso parece exagero no início. Com 6 meses de uso e 20+ fluxos configurados, você vai agradecer por ter feito.

O timeout padrão de sessão é 48 horas desde a v2026.3.22. Na maioria dos cenários pessoais e MEI, você não precisa ajustar. Se rodar atendimento em equipe e quiser sessões mais curtas por segurança, configure session.idleMinutes no openclaw.json.

O Que Documentar (e o Que Pular)

Você não precisa documentar tudo. Mas alguns registros são essenciais:

Documente obrigatoriamente:

Para cada fluxo: o que ele faz, o que o dispara, quais APIs usa, o que pode falhar
Para cada integração de API: onde está a chave, quando expira, o que fazer se revogar
Para cada cron: o horário, o fuso horário, o que faz, como verificar se rodou

Pule com segurança:

Documentação de configurações óbvias (“o campo nome recebe o nome”)
Comentários que só repetem o que o nome já diz
Diagramas elaborados para fluxos simples de 3 passos

Formato prático: um arquivo FLUXOS.md na raiz do seu projeto com uma tabela:

| Fluxo | Disparo | API | Última revisão |
|-------|---------|-----|----------------|
| whatsapp-atendimento-inicial | Nova mensagem WA | WA Business | 2025-03 |
| cron-lembrete-das | Dia 15 às 8h BRT | - | 2025-01 |
| whatsapp-cobrança-pix | Novo pedido | Mercado Pago | 2025-03 |

Cinco minutos para criar, cinco segundos para consultar quando precisar.

Monitoramento: Saber Antes do Cliente

O objetivo do monitoramento é simples: você descobre que algo quebrou antes do seu cliente descobrir.

O mínimo viável:

Log de execução: cada vez que um fluxo roda, registre: horário de início, horário de fim, resultado (sucesso/erro), identificador da execução. Esses logs ficam em banco de dados ou arquivo de texto.

Alerta de falha: quando um fluxo retorna erro, OpenClaw envia uma mensagem para você no WhatsApp ou Telegram. Não email — email você pode não ver a tempo. Mensagem no WhatsApp você vê.

Alerta de ausência (dead man’s switch): para cron jobs críticos, um sistema que detecta quando o job não rodou no prazo esperado. Serviço Healthchecks.io faz isso gratuitamente para projetos pequenos — cada cron manda um ping ao finalizar, e se o ping não chegar, você recebe alerta.

Revisão semanal: reserva 30 minutos por semana para olhar os logs. Não para resolver problema — para detectar tendências antes que virem problemas. Taxa de erro crescendo? Tempo de resposta aumentando? Fluxo rodando mais do que deveria?

Memória do agente: o sistema de memória da v2026.3.22 inclui indexação vetorial com busca híbrida (BM25 + semântica), re-ranking por diversidade (MMR) e decaimento temporal. Memórias antigas perdem relevância automaticamente — a menos que sejam reforçadas. Antes de compactar contexto, o OpenClaw salva notas no disco automaticamente.

Custo Mensal: Estimativa Realista para MEI

Para um MEI típico com o stack descrito neste guia:

Item	Custo estimado (R$)
VPS Hostinger KVM2	R$ 43,99/mês
API Anthropic (Haiku + Sonnet)	R$ 20-50/mês
WhatsApp Business API (via BSP)	R$ 30-80/mês
Mercado Pago (taxa por transação)	% do volume
Healthchecks.io	Grátis (plano básico)
Total fixo	R$ 87-167/mês

O custo de WhatsApp Business API varia bastante dependendo do volume de mensagens e do BSP (Business Solution Provider) que você usa. Para volumes baixos (menos de 1.000 conversas/mês), pode ser bem menor.

Para comparação: uma atendente de meio período custa R$ 1.000-1.500/mês em salário, sem contar encargos. Mesmo no teto da estimativa acima (R$ 167/mês), a automação é uma fração do custo — com disponibilidade 24/7.

Mas não é substituição de pessoa — é extensão de capacidade. Para problemas que exigem julgamento humano, você ainda precisa estar disponível.

Estratégia de Backup

O que acontece se o servidor cair, o banco de dados corromper, ou você precisar migrar para outro provedor?

Dados que precisam de backup:

Configuração dos fluxos do OpenClaw (exportar regularmente)
Banco de dados com histórico de pedidos, clientes, execuções
Variáveis de ambiente e chaves de API (guardar em gerenciador de senhas como Bitwarden, não em arquivo de texto no servidor)

Frequência recomendada:

Configurações dos fluxos: backup semanal
Banco de dados: backup diário (a maioria dos VPS oferece backup automático pago — vale o custo extra)

Hostinger tem opção de backup semanal por alguns reais extras por mês. Para dados de negócio, é custo que vale.

Escalando Incrementalmente

Uma das armadilhas mais comuns é tentar automatizar tudo na largada. Além de ser mais trabalho do que parece, cria um sistema frágil que você não entende completamente.

A progressão saudável:

Mês 1: um fluxo funcionando bem. Aprende como o OpenClaw se comporta, quais são os limites, como debugar.

Mês 2-3: dois ou três fluxos. Começa a ter padrões — identifica o que repete, o que pode ser componente reutilizável.

Mês 4+: começa a compor fluxos. Um fluxo chama outro. Um evento gera múltiplas reações. O sistema começa a parecer um sistema.

Cada novo fluxo que você adiciona é uma nova coisa que pode quebrar. Adicione um por vez, monitore por uma semana, e só depois adicione o próximo.

Erros Comuns para Evitar

Over-automation: automatizar processos que ainda não estão estáveis. Se você muda a forma de cobrar clientes todo mês, não automatize a cobrança ainda. Automatize o que já é rotina previsível.

Under-monitoring: ter automações rodando sem saber se estão funcionando. Isso é tempo bomb — você só descobre o problema quando o cliente reclama.

Ignorar LGPD: dados de clientes brasileiros (nome, email, telefone, histórico de compras) são dados pessoais cobertos pela Lei Geral de Proteção de Dados. Você precisa de base legal para coletar (geralmente consentimento ou contrato), precisa saber onde esses dados estão, e precisa conseguir deletar se o cliente pedir. Não é assunto para ignorar.

Chaves de API no código: nunca coloque chaves de API diretamente no código ou em arquivos versionados. Use variáveis de ambiente. Uma chave exposta no GitHub pode ser usada por terceiros — e a fatura vem para você.

Isolamento do agente: para isolamento do agente, o OpenClaw suporta 3 backends de sandbox desde a v2026.3.22: Docker (o mais seguro — --cap-drop ALL, --read-only, --network none), OpenShell (leve, sem dependência de Docker), e SSH (executa em máquina remota). Em VPS dedicado com sandbox Docker, o risco de vazamento é mínimo.

Dependência de um único ponto de falha: se toda a automação depende de uma API externa, o que acontece quando essa API fica fora do ar? Tenha fallback manual documentado para fluxos críticos.

A Verdade Sobre Automação

Sistemas de automação quebram. APIs mudam sem aviso. O WhatsApp atualiza termos de uso. Um modelo de IA começa a responder diferente depois de uma atualização. O servidor precisa de manutenção.

Construir para resiliência significa aceitar que vai quebrar e planejar para quando — não se — isso acontecer. Fluxos críticos têm fallback manual. Alertas chegam rápido. Documentação existe para que você (ou alguém) consiga restaurar em horas, não dias.

A promessa honesta da automação: menos trabalho repetitivo, mais consistência, mais disponibilidade. Não perfeição. Não zero manutenção. Não “configura uma vez e esquece para sempre”.

O profissional que entende isso constrói sistemas duráveis. O que não entende passa os fins de semana apagando incêndios.

Na Prática

Cenário: Lanchonete MEI “Marmitas da Dona Cida” — atendimento WhatsApp, cobrança PIX, relatório semanal para a dona.

Stack escolhido:

Infraestrutura: Hostinger KVM2 (R$ 43,99/mês), São Paulo
Modelos: Claude Haiku (triagem) + Claude Sonnet (mensagens personalizadas)
Canais: WhatsApp (via Twilio BSP)
Pagamentos: Mercado Pago PIX
Dados: SQLite (volume baixo, backup diário)
Monitoramento: logs em arquivo + alertas WhatsApp + Healthchecks.io

Fluxos configurados (ordem de implementação):

whatsapp-atendimento-inicial — triagem com menu de opções
whatsapp-cobrança-pix — confirmação de pedido + geração PIX
whatsapp-status-pedido — atualizações de status em tempo real
cron-relatorio-semanal — toda segunda às 8h, resumo da semana para a Cida
cron-lembrete-das — dia 15 de cada mês, lembrete do DAS

Custo mensal total estimado: R$ 120-160/mês (VPS + APIs + WhatsApp)

Resultado após 3 meses: a Cida para de responder as mesmas perguntas repetitivas e foca no que importa — a comida. Tempo economizado: ~1,5 hora por dia. Pedidos que antes perdiam por demora na resposta: recuperados.

Para começar, volte ao índice do guia e siga a sequência dos capítulos. Se quiser ir direto para o servidor, a seção de VPS tem comparativos detalhados. Se quiser templates prontos para os fluxos descritos aqui, a biblioteca de templates é o próximo passo.

Se tiver dúvida, a comunidade do OpenClaw Club Brasil está no WhatsApp — acesse em /comecar/.

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