Skills de IA com Vibecoding e Terminal · Capítulo 10 de 12 · 30 min
Orquestração Persistente: OpenClaw e Agentes que Vivem 24/7
Quando o Claude Code não basta: agentes em Telegram, WhatsApp e Slack, com memória, cronjobs e personalidade.
Este capítulo faz parte do curso gratuito Skills de IA com Vibecoding e Terminal.
Claude Code é excelente para sessões ativas no seu terminal. Mas e quando você precisa de um agente que viva 24 horas, que responda no Telegram às duas da manhã, que execute cronjobs de verificação e que mantenha memória entre conversas? Aí entra a categoria de gateways agênticos persistentes. A opção open-source mais madura em 2026 é o OpenClaw, projeto iniciado em 2025 e hoje com instalações ativas em dezenas de milhares de máquinas.
O OpenClaw é um daemon local que expõe seu agente de IA via múltiplos canais: Telegram, WhatsApp Business, Discord, Slack, e-mail. Ele roda em segundo plano, mantém sessões isoladas por canal, persiste memória em arquivos Markdown e suporta ferramentas via MCP -- o mesmo protocolo que você aprendeu no módulo anterior.
Arquitetura do OpenClaw em camadas
Camada de transporte -- handlers de Telegram, WhatsApp, Discord, Slack. Recebem eventos externos e convertem em mensagens internas.
Camada de sessão -- cada canal (e cada contato dentro do canal) tem sessão isolada com contexto próprio. Você pode falar com o agente no Telegram com um tom, e ele responde no Slack com outro tom.
Camada de memória -- arquivos Markdown em ~/.openclaw/ que definem o comportamento. Quatro arquivos de referência: SOUL.md (personalidade), USER.md (dados do usuário), AGENTS.md (instruções operacionais), HEARTBEAT.md (cronjobs).
Camada de execução -- MCP para tools externas, scripts locais para operações de sistema, acesso a LLM via API (Anthropic, OpenAI, Gemini).
# Instalacao do OpenClaw
# Requer Node.js 20+
npm install -g @openclaw/cli
openclaw init
# O init cria estrutura em ~/.openclaw/
# ~/.openclaw/
# SOUL.md # personalidade
# USER.md # dados do usuario
# AGENTS.md # instrucoes operacionais
# HEARTBEAT.md # cronjobs
# channels/
# telegram.yml
# slack.yml
# skills/ # skills no padrao Anthropic
# logs/
# Configuracao de Telegram (exemplo)
# Crie bot via @BotFather no Telegram, anote o token
openclaw channel:add telegram --token 'SEU_TOKEN'
openclaw start
# Mande uma mensagem para o seu bot no Telegram.
# O OpenClaw recebe, roteia para o LLM, responde.# Exemplo de SOUL.md (personalidade do agente)
# Voce e o assistente pessoal do Alexandre Caramaschi,
# Founder da Brasil GEO. Seu nome e Naia.
## Tom de voz
- Direta, sem floreios
- PT-BR com acentuacao completa
- Cita numeros quando disponiveis, nunca aproxima
- Usa pouco humor, mas quando usa, e seco
## Contexto da empresa
- Brasil GEO e especialista em Generative Engine Optimization
- Clientes principais: Natura, operadoras de saude, escritorios de advocacia
- Deadlines frequentes, ambiente acelerado
## Regras duras
- Nunca cite credenciais nao-canonicas do Alexandre
- Nunca mencione valores especificos de contrato
- Nunca confirme agenda sem verificar Calendar via MCP
- Em duvida, pergunte antes de agir
## Fluxo em caso de urgencia
- Se mensagem contem 'urgente' ou 'emergencia'
1. Responda imediatamente confirmando recebimento
2. Notifique Alexandre via canal prioritario
3. Registre em logs/urgencias/
O HEARTBEAT.md é o que transforma o agente em 'sempre ligado'. Esse arquivo define verificações periódicas que rodam sozinhas -- cronjobs expressos em linguagem natural + horário. O OpenClaw compila essas instruções em tarefas agendadas e dispara o LLM quando a hora chegar.
Caso real de HEARTBEAT útil: 'Todo dia às 6h da manhã, consulte os últimos deploys Vercel das últimas 24h via MCP. Se algum falhou, notifique no Slack da Brasil GEO. Caso contrário, envie um resumo de 2 linhas.' Isso vira um digest diário automático sem nenhuma linha de código além do Markdown.
Skills do Claude Code funcionam no OpenClaw. O formato é o mesmo. Uma skill content-voice-guard que você construiu em ~/.claude/skills/ pode ser copiada para ~/.openclaw/skills/ e ativada. O agente no Telegram passa a validar acentos quando alguém pedir. É o mesmo repertório de habilidades vivendo em múltiplos canais.
Agentes 24/7 custam. Cada mensagem dispara chamada de LLM. Em canais com tráfego alto, o bill mensal sobe rápido. Implemente budget cap no HEARTBEAT.md ('se uso diário passar de 50.000 tokens, pause e notifique') e use Haiku ou Sonnet para interações rotineiras, reservando Opus para tarefas de raciocínio pesado. Quem deixa Opus atendendo Telegram 24h paga conta feia no fim do mês.
Segurança multi-canal. Cada canal é superfície de ataque. Alguém que conseguir acesso ao seu Telegram fala com o agente com os seus privilégios. Configure allow-list de contatos (apenas IDs autorizados podem dar comandos que executam ações), exija confirmação em duas etapas para ações sensíveis (pagamentos, mudanças de infra) e registre todas as execuções em log auditável.
Nem todo trabalho recorrente precisa de um daemon ligado 24 horas. O relatório semanal de mídia é o exemplo clássico: roda uma vez por semana, lê arquivos e entrega um documento. Três peças resolvem sem servidor: uma skill que roda num subagente isolado (context: fork), um subagente com ferramentas limitadas e o modo não interativo do terminal, agendado pelo próprio sistema operacional.
# .claude/agents/analista-midia.md
---
name: analista-midia
description: Lê exportações de mídia paga e escreve a análise semanal por campanha.
tools: Read, Grep, Glob, Write
model: sonnet
---
Você é analista de mídia. Compare cada campanha com a semana anterior,
separando o que o dado mostra do que é hipótese. Nunca invente número.
# .claude/skills/relatorio-midia-semanal/SKILL.md
---
name: relatorio-midia-semanal
description: Gera o relatório semanal de mídia paga a partir das exportações em dados/midia/. Use quando pedirem relatório semanal, resumo de mídia ou desempenho da semana.
context: fork
agent: analista-midia
---
1. Leia os CSVs da semana em dados/midia/ (Google Ads, Meta, LinkedIn).
2. Por campanha: investimento, impressões, cliques, leads, custo por lead
e variação contra a semana anterior.
3. Destaque os 3 melhores anúncios com gasto, resultado por etapa do funil
e o porquê, com evidência separada de hipótese.
4. Salve em relatorios/midia-<data>.md.
# Agendamento toda segunda às 8h (crontab no macOS ou Linux)
0 8 * * 1 cd ~/projetos/marketing && claude -p "/relatorio-midia-semanal" --allowedTools "Read,Grep,Glob,Write"
# No Codex, o equivalente não interativo:
# codex exec "use a skill relatorio-midia-semanal"Relatório semanal de mídia sem servidor ligado
Entrada: exportações semanais das plataformas em dados/midia/. Saída: um Markdown por semana em relatorios/.
Passo 1: Padronize as exportações: um CSV por plataforma, com as mesmas colunas e o período no nome do arquivo.
Colunas mínimas: campanha, anúncio, investimento, impressões, cliques, leads. Nome do arquivo com a data inicial da semana.
Deu certo quando: Abrir os três CSVs lado a lado mostra as mesmas colunas, na mesma ordem.
Erro comum: Misturar moedas ou fusos entre plataformas: a comparação semanal fica errada sem nenhum aviso.
Passo 2: Crie o subagente analista-midia com ferramentas só de leitura e escrita de arquivo.
Sem Bash e sem acesso à web, ele não altera campanha nem envia nada; só lê e escreve o relatório.
Deu certo quando: Pedir "use o analista-midia para resumir dados/midia/" devolve a análise sem pedir permissão para comandos.
Passo 3: Crie a skill com context: fork e agent: analista-midia e rode /relatorio-midia-semanal à mão uma vez.
O fork roda a skill num contexto limpo, sem o histórico da conversa, e devolve só o resultado.
Deu certo quando: relatorios/midia-<data>.md aparece com as três seções e os três melhores anúncios.
Erro comum: Esperar que o subagente lembre da conversa: ele não vê o histórico. Tudo o que importa vai no SKILL.md.
Passo 4: Agende com claude -p e --allowedTools, e confira o primeiro relatório automático.
No modo não interativo, /nome-da-skill dentro do texto do prompt é expandido antes da execução. No Windows, use o Agendador de Tarefas com o mesmo comando.
Deu certo quando: Na segunda-feira, o arquivo da semana existe sem ninguém abrir o terminal.
Erro comum: Agendar com permissão total (bypass) para não parar no meio. Libere só as ferramentas que a skill usa.
No fim você tem: Um relatório semanal consistente, com custo de uma execução por semana e nenhuma máquina servindo 24 horas.
Teto de delegação já vem de fábrica. Desde julho de 2026, o Claude Code limita uma sessão a 20 subagentes rodando ao mesmo tempo (CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS) e a 200 subagentes criados por sessão (CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION). Para relatório agendado, mantenha esses valores: um laço de delegação descontrolado vira fatura alta antes de alguém perceber.
Você conhece a arquitetura do OpenClaw, sabe o papel de SOUL.md, USER.md, AGENTS.md e HEARTBEAT.md, instalou o canal Telegram como exemplo e entende o modelo de custo e segurança de agentes persistentes.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- CursoClaude Code CLI: Programação com IA
- Veja o que o Claude Code faz antes de instalarsugerido pelo grafoApresenta o conceito “Claude Code”, usado em “Orquestração Persistente: OpenClaw e Agentes que Vivem 24/7”.
- CursoSetup Completo: do zero ao Claude Codesugerido pelo grafo5 capítulos de “Skills de IA com Vibecoding e Terminal” usam conceitos apresentados em “Setup Completo: do zero ao Claude Code”.
- CursoVibecoding para SEOsugerido pelo grafo3 capítulos de “Skills de IA com Vibecoding e Terminal” usam conceitos apresentados em “Vibecoding para SEO”.
Depois, siga para
- CursoFrontends com Vibecodingsugerido pelo grafo9 capítulos de “Frontends com Vibecoding” usam conceitos apresentados em “Skills de IA com Vibecoding e Terminal”.
- CursoPrompt Engineering para Executivossugerido pelo grafo3 capítulos de “Prompt Engineering para Executivos” usam conceitos apresentados em “Skills de IA com Vibecoding e Terminal”.
- CursoRLM 2027sugerido pelo grafo2 capítulos de “RLM 2027” usam conceitos apresentados em “Skills de IA com Vibecoding e Terminal”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Claude Code CLI: Programação com IARevisar o plano antes de agir e ligar suas ferramentasExaminar conexões de Revisar o plano antes de agir e ligar suas ferramentas
- Vídeo com IA: Claude Code, Codex e ElevenLabsEstruturar o projeto de vídeo para o Claude Code operar sem improvisarExaminar conexões de Estruturar o projeto de vídeo para o Claude Code operar sem improvisar
- Setup de Vibecoding no MacSub-agents — Claudes ajudantes em paralelo (opcional)Examinar conexões de Sub-agents — Claudes ajudantes em paralelo (opcional)
- Agentes de IA Autônomos: Do Conceito à ProduçãoGuardrails e segurançaExaminar conexões de Guardrails e segurança
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.