Jobs Cron OpenClaw: Automatize a Rotina Diária do Seu Agente

Aprenda como configurar jobs cron no OpenClaw para agendar tarefas recorrentes — de resumos de email a auditorias de segurança. Inclui exemplos práticos com código.

Por Maya

Jobs Cron OpenClaw: Automatize a Rotina Diária do Seu Agente

O melhor agente de IA é aquele que você não precisa supervisionar. Jobs cron permitem que seu agente OpenClaw faça coisas em horários programados — verificar email, scanear problemas de segurança, resumir notícias, enviar um briefing matinal — sem você digitar uma única mensagem.

Executo cerca de 15 jobs cron na minha própria configuração. Alguns disparam a cada 30 minutos, outros uma vez por semana. Juntos lidam com talvez 60% do que costumava ser trabalho manual de verificação.

Aqui está como configurá-los e alguns padrões que realmente funcionam na prática.

Como Jobs Cron Funcionam no OpenClaw

Um job cron é uma tarefa agendada. Você define três coisas:

  1. Quando executa (cronograma)
  2. O que faz (payload)
  3. Para onde vai o output (delivery)

Cada job executa em sua própria sessão isolada. Isso significa que recebe uma janela de contexto fresca, não interfere na sua conversa principal e pode usar um modelo diferente se você quiser.

Criando Seu Primeiro Job Cron

A abordagem mais simples — através da CLI:

openclaw cron add \
  --name "Briefing Matinal" \
  --schedule "0 8 * * *" \
  --message "Verifique meus emails não lidos, calendário de hoje e o tempo em São Paulo. Me dê um resumo de 3 parágrafos."

Isso dispara às 8:00 todo dia. O agente lê seu email (se você configurou a skill do Gmail), verifica seu calendário, pega dados do tempo e envia o resumo.

Você também pode criar jobs através do dashboard ou perguntando ao seu agente diretamente no chat: "Configure um job cron diário às 8h que verifica meu email e calendário."

Sintaxe de Agendamento

OpenClaw suporta expressões cron padrão:

┌───── minuto (0-59)
│ ┌───── hora (0-23)
│ │ ┌───── dia do mês (1-31)
│ │ │ ┌───── mês (1-12)
│ │ │ │ ┌───── dia da semana (0-7, 0 e 7 = Domingo)
│ │ │ │ │
* * * * *

Padrões comuns:

| Agendamento | Expressão | Caso de Uso | |------------|------------|-------------| | Toda manhã às 8h | 0 8 * * * | Briefing diário | | A cada 30 minutos | */30 * * * * | Monitoramento de caixa de entrada | | Segunda e quinta às 9h | 0 9 * * 1,4 | Publicação de conteúdo | | Primeiro dia do mês ao meio-dia | 0 12 1 * * | Relatório mensal | | Dias úteis às 18h | 0 18 * * 1-5 | Resumo fim de dia |

Você também pode definir um fuso horário. Padrão é UTC, mas provavelmente quer seu horário local:

{
  "schedule": {
    "kind": "cron",
    "expr": "0 8 * * *",
    "tz": "America/Sao_Paulo"
  }
}

Tipos de Payload

Eventos do Sistema (para sua sessão principal)

Injeta uma mensagem na sua conversa existente:

{
  "payload": {
    "kind": "systemEvent",
    "text": "Lembrete: reunião standup em 15 minutos"
  }
}

Bom para lembretes e cutucadas. A mensagem aparece no seu chat principal como se o sistema a enviasse.

Turnos de Agente (execução isolada)

Executa o agente com um prompt específico em sua própria sessão:

{
  "payload": {
    "kind": "agentTurn",
    "message": "Pesquise as 5 principais histórias do HackerNews de hoje e escreva um resumo de 200 palavras de cada",
    "model": "anthropic/claude-sonnet-4-20250514"
  }
}

O agente faz o trabalho independentemente. Quando termina, pode entregar o resultado ao seu chat ou canal específico.

Opções de Entrega

Para onde o output deve ir após o job executar?

  • announce — envia o resumo ao seu chat (padrão para jobs isolados)
  • webhook — faz POST do resultado para uma URL
  • none — executa silenciosamente, útil para tarefas de manutenção
{
  "delivery": {
    "mode": "announce",
    "channel": "telegram"
  }
}

Padrões de Cron do Mundo Real

Padrão 1: Triagem de Email

openclaw cron add \
  --name "Verificação Email" \
  --schedule "*/30 * * * 1-5" \
  --message "Verifique minha caixa de entrada do Gmail. Para emails não lidos dos últimos 30 minutos: resuma o remetente, assunto e se precisa resposta. Se algo parecer urgente, sinalize."

Executa a cada 30 minutos em dias úteis. Meu agente categoriza emails em "precisa resposta," "apenas FYI" e "spam/marketing." Me poupa de verificar email a cada 5 minutos.

Padrão 2: Auditoria de Segurança

openclaw cron add \
  --name "Verificação Segurança" \
  --schedule "0 3 * * *" \
  --message "Execute openclaw security audit --deep. Se problemas forem encontrados, os resuma com níveis de severidade. Verifique tentativas falhas de login SSH nas últimas 24 horas. Reporte novas portas em escuta."

Executa às 3h diariamente. Acordo com "tudo limpo" ou uma lista específica de coisas para olhar.

Padrão 3: Pipeline de Conteúdo

openclaw cron add \
  --name "Publicador Blog" \
  --schedule "0 9 * * 1,4" \
  --message "Verifique projects/blog/queue/ para posts marcados como prontos. Para cada um: valide frontmatter, execute verificação ortográfica final, então publique movendo para o diretório de conteúdo e executando script de deploy."

Segundas e quintas às 9h. Enfilerio posts de blog durante a semana, e o agente cuida da publicação real.

Padrão 4: Status de Projeto

openclaw cron add \
  --name "Status Semanal" \
  --schedule "0 17 * * 5" \
  --message "Gere um relatório de status semanal. Verifique logs git para todos repos em ~/projects/. Resuma commits, issues abertas e execuções CI falhadas. Formate como relatório breve."

Sexta às 17h. Um snapshot rápido do que aconteceu em todos meus projetos naquela semana.

Gerenciando Jobs Cron

Liste todos seus jobs:

openclaw cron list

Verifique histórico de execução para job específico:

openclaw cron runs --job-id JOB_ID

Desabilite sem deletar:

openclaw cron update --job-id JOB_ID --enabled false

Dispare um job manualmente (útil para teste):

openclaw cron run --job-id JOB_ID

Delete um job:

openclaw cron remove --job-id JOB_ID

Controle de Custo

Cada job cron dispara uma chamada de modelo IA. Com 15 jobs executando ao longo do dia no Sonnet, gasto aproximadamente R$ 25-50/mês apenas em tarefas agendadas. Algumas coisas que ajudam:

  • Use Haiku para verificações simples. Triagem de email não precisa raciocínio nível-Opus. Especifique o modelo no payload.
  • Não execute coisas mais frequentemente que necessário. Verificações de email a cada 5 minutos queimam tokens por benefício mínimo sobre verificações a cada 30 minutos.
  • Defina timeouts. Uma tarefa de pesquisa travada pode inflar sua conta. Adicione "timeoutSeconds": 120 ao payload.
  • Agrupe verificações relacionadas. Em vez de três jobs separados para email, calendário e tempo, combine em um job de briefing matinal.

Debugando Falhas

Jobs falham às vezes. O agente não conseguiu conectar ao Gmail, ou a busca web não retornou nada, ou o modelo atingiu limite de taxa. Verifique o histórico de execução:

openclaw cron runs --job-id JOB_ID

Cada execução mostra o status (completado, falhado, timeout) e o output completo. Olhe o raciocínio do agente — geralmente explica o que deu errado.

Correções comuns:

  • Auth expirou — re-autentique a skill (Gmail, calendário, etc.)
  • Rate limited — espaçe seus jobs ou use modelo diferente
  • Timeout — aumente o timeout ou simplifique o prompt
  • Output vazio — o agente executou mas não tinha nada para reportar. Tudo bem — talvez não houvesse emails novos.

Comece Pequeno, Expanda Depois

Não configure 20 jobs cron no primeiro dia. Comece com um briefing diário. Veja se o output é útil. Ajuste o prompt até dar o que realmente quer. Então adicione um segundo job. Construa sua camada de automação gradualmente.

O ponto todo é reclamar atenção. Cada job cron que funciona bem é uma coisa a menos que você tem que lembrar de verificar manualmente.

Para mais sobre construir fluxos automatizados, veja nosso guia sobre construir pipelines de conteúdo IA ou a documentação oficial OpenClaw.