Cron Jobs no OpenClaw: como automatizar tarefas com IA

Com o recurso Cron Job do OpenClaw, um assistente de IA pode executar tarefas de forma proativa: preparar relatórios sobre a movimentação de ações, analisar e-mails importantes ou ajustar dispositivos de casa inteligente de acordo com a previsão do tempo. Isso é muito mais eficiente do que o modo de perguntas e respostas: abrir o OpenClaw de manhã para perguntar sobre o tempo e a agenda, consultar cotações manualmente ao meio-dia e verificar portas e janelas antes de dormir são tarefas repetitivas que podem ser automatizadas.

Para ser sincero, naquela época eu sempre pensava: se a IA é tão inteligente, por que não pode cuidar dessas tarefas de forma proativa? Só depois de descobrir o recurso Cron Job do OpenClaw entendi de verdade o que significa ter um “agente autônomo”.

Guia econômico para criar seu “lagostim”: o ArkClaw torna os agentes de IA realmente acessíveis

O OpenClaw, o famoso “lagostim”, é útil, mas a configuração afasta muita gente. O ArkClaw, da Volcengine, reduz essa barreira ao mínimo. Sem precisar lidar com servidores nem configurar tokens, um clique basta para ter um agente de IA disponível 24 horas por dia, capaz de controlar o navegador, executar scripts e gerenciar o calendário.

O destaque é o preço: a mensalidade custa apenas 9,9 yuans e, com meu código de convite ZLKUK54M (cadastre-se aqui), sai por 8,9 yuans. Para quem programa, o Coding Plan Pro permite usar o serviço sem custo adicional.

Por que você precisa de tarefas agendadas com IA

Talvez você já tenha sentido isso: os assistentes de IA tradicionais são capazes, mas se comportam como um atendimento reativo — se você não pergunta, eles não dizem nada. Esse modelo funciona bem para questões pontuais, mas fica trabalhoso quando a tarefa precisa ser verificada ou repetida regularmente.

Vou dar um exemplo real. Um amigo meu investe em ações e costumava consultar manualmente, todos os dias, a variação de preço de alguns papéis importantes. Certa vez, ficou preso em uma reunião, esqueceu de acompanhar o mercado e perdeu um momento importante de venda, acumulando um prejuízo de dezenas de milhares. Depois ele reclamou comigo: “Se a IA pudesse me avisar sozinha, seria ótimo”.

Esse é o problema: o trabalho repetitivo consome tempo, e informações importantes podem passar despercebidas no momento decisivo.

Também tenho um exemplo pessoal. Todas as manhãs, preciso conferir a previsão do tempo, meus compromissos e as notícias importantes do dia. Com um assistente de IA comum, eu tinha de fazer essas três perguntas manualmente, gastando vários minutos só para digitar. Depois que configurei as tarefas agendadas do OpenClaw, essas informações passaram a chegar automaticamente ao meu Telegram todos os dias às 7h. Consigo ler tudo enquanto escovo os dentes.

Esse é o valor do modo proativo: liberar sua atenção para o trabalho criativo, em vez de gastá-la com operações repetitivas.

Conceitos fundamentais dos Cron Jobs no OpenClaw

Se você já usou Linux, provavelmente conhece o termo “Cron”. Em resumo, Cron é um mecanismo de agendamento que permite executar automaticamente um programa em um horário específico. Você pode, por exemplo, fazer backup do banco de dados todos os dias às 2h ou enviar um lembrete de relatório semanal às 9h de segunda-feira.

O Cron Job do OpenClaw leva esse mecanismo para o assistente de IA, mas oferece mais inteligência do que um Cron tradicional. Segundo a documentação técnica mais recente de 2026, o OpenClaw gerencia todas as tarefas cron por meio do agendador do Gateway e as recupera automaticamente após uma reinicialização, mantendo sua execução persistente.

Dois modos de execução: Main e Isolated

O OpenClaw oferece dois modos de execução. No começo eu também os confundia, mas depois entendi a diferença:

1. Modo Main Session

Nesse modo, a tarefa agendada é executada na conversa principal. Na prática, funciona como uma conversa normal com o OpenClaw: ele consegue consultar o histórico anterior e conhece suas preferências e informações de contexto.

Quando usar:

• Tarefas que exigem conteúdo personalizado, como um boletim diário no qual a IA sabe quais notícias interessam a você
• Tarefas que dependem de contexto, como continuar o documento de ontem
• Tarefas complexas que precisam usar todo o histórico da conversa

2. Modo Isolated Session

Esse modo cria um espaço de execução independente (cron:<jobId>) para a tarefa agendada, sem afetar a conversa principal. É como abrir uma conta separada dedicada àquela tarefa.

Quando usar:

• Monitoramentos frequentes, como verificar o preço de ações a cada 30 minutos
• Tarefas que não precisam do histórico da conversa, como consultar o tempo
• Tarefas que geram muito conteúdo e poderiam atrapalhar a conversa principal, como analisar grandes volumes de logs

Visão geral dos principais recursos

Os Cron Jobs do OpenClaw têm alguns recursos de que gosto bastante:

Suporte à sintaxe Cron padrão
Se você já usou o Cron no Linux, a sintaxe será familiar. 0 7 * * * significa todos os dias às 7h, enquanto */30 * * * * significa a cada 30 minutos.

Envio por vários canais
O resultado da execução pode ser enviado para Telegram, WhatsApp ou Slack. Eu costumo usar o Telegram porque vejo as notificações no celular em tempo real.

KiloClaw - OpenClaw gerenciado para empresas: orquestração de agentes IA e roteamento inteligente

Começar →Anúncio

Armazenamento persistente
As tarefas configuradas ficam salvas em ~/.openclaw/cron/jobs.json. Mesmo que o OpenClaw Gateway seja reiniciado, elas não são perdidas.

Ativação imediata (Wake Now)
Quando uma tarefa é urgente e você não quer esperar o horário programado, o parâmetro --now permite executá-la imediatamente. Isso é especialmente útil para testes.

Limpeza automática
Tarefas de execução única, como um lembrete para uma reunião amanhã às 15h, são removidas automaticamente após serem concluídas com sucesso.

Modo de entrega BestEffort
Esse é um recurso muito prático: quando ativado, uma falha no envio da notificação, causada por um problema de rede, por exemplo, não impede a próxima execução da tarefa.

Como configurar seu primeiro Cron Job

Já vimos a teoria; agora vamos à prática. Vou mostrar como configurar um dos cenários mais úteis: um boletim matinal diário.

Definição do cenário

Quero que a IA envie automaticamente, às 7h de cada dia útil, um boletim com:

1. A previsão do tempo para hoje
2. Os eventos importantes do calendário
3. Algumas notícias de tecnologia
4. Uma frase motivacional — isso é apenas uma preferência pessoal

Etapas de configuração

Etapa 1: adicionar uma nova tarefa

Abra o terminal e execute:

openclaw cron add --name "Morning Brief"

Esse comando cria uma nova entrada de tarefa no arquivo de configuração.

Etapa 2: editar o arquivo de configuração

nano ~/.openclaw/cron/jobs.json

Se você não costuma usar o nano, pode abrir o arquivo com vim ou qualquer editor de sua preferência.

Etapa 3: preencher a configuração

No arquivo aberto, encontre a tarefa que acabou de criar e altere-a para:

{
  "name": "Morning Brief",
  "schedule": "0 7 * * 1-5",
  "skill": "daily-brief",
  "action": "main",
  "prompt": "Crie o boletim de hoje: 1) previsão do tempo local 2) eventos do meu calendário, obtidos do Google Calendar 3) três notícias importantes do setor de tecnologia 4) uma frase motivacional adequada para hoje",
  "notify": {
    "channel": "telegram",
    "bestEffort": true
  }
}

Detalhes da configuração

Veja o que cada campo significa:

name: nome da tarefa. Você pode escolher qualquer um que facilite a identificação.

schedule: regra de agendamento. Neste caso, 0 7 * * 1-5 significa:

• 0 — minuto 0, ou seja, hora cheia
• 7 — 7h da manhã
• * — qualquer dia do mês
• * — qualquer mês
• 1-5 — de segunda a sexta-feira, sem executar no fim de semana

skill: skill a ser chamada. Se você configurou uma skill personalizada, informe o nome; caso contrário, pode escrever a instrução diretamente no campo prompt.

action: modo de execução. Aqui usamos main porque quero que a IA conheça minhas preferências, como a cidade onde moro e as áreas de tecnologia que acompanho.

prompt: instrução específica para a tarefa. Quanto mais detalhes você fornecer, mais precisa será a execução pela IA.

notify: configuração das notificações.

• channel: canal de envio; eu uso o Telegram
• bestEffort: isso é importante. O valor true indica que uma falha de envio, causada por um problema de rede, por exemplo, não impedirá a próxima execução da tarefa

Como validar e testar

Depois de configurar, não espere até as 7h do dia seguinte. Faça um teste primeiro:

Listar as tarefas configuradas

openclaw cron list

A tarefa “Morning Brief” recém-configurada deve aparecer na lista.

Executar um teste imediato

openclaw cron run "Morning Brief" --now

Esse comando aciona a tarefa imediatamente, sem esperar até as 7h. Se a configuração estiver correta, a mensagem deve chegar ao Telegram em pouco tempo.

Consultar o histórico de execuções

Alibaba Cloud - Escolha dos desenvolvedores, 15% de desconto exclusivo em Lighthouse

Ganhar 15% off →Anúncio

openclaw cron runs

Esse comando mostra os registros de execução de todas as tarefas, incluindo o número de sucessos e os motivos das falhas. Se algo não ocorrer como esperado, procure pistas aqui.

Cenários práticos de uso

Depois de configurar a primeira tarefa, talvez você se pergunte: “O que mais posso fazer com um Cron Job?”. Há muitas possibilidades. A seguir estão alguns cenários que uso no dia a dia.

Cenário 1: monitoramento do preço de ações

Lembra do meu amigo investidor? Agora ele usa esta configuração:

{
  "name": "Stock Price Monitor",
  "schedule": "*/30 9-16 * * 1-5",
  "skill": "stock-monitor",
  "action": "isolated",
  "prompt": "Verifique o preço atual destas ações: AAPL, GOOGL e TSLA. Se o preço de qualquer uma variar mais de 3%, envie imediatamente as informações detalhadas. Caso contrário, não envie nada.",
  "notify": {
    "channel": "telegram",
    "condition": "price_alert_triggered"
  }
}

Pontos principais:

• */30 9-16 * * 1-5: verifica a cada 30 minutos durante o horário de negociação, das 9h às 16h
• action: "isolated": usa o modo isolado para que os resultados obtidos a cada meia hora não poluam a conversa principal
• condition: envia uma notificação apenas quando a condição é atendida, evitando alertas desnecessários

Depois de configurar essa tarefa, ele nunca mais perdeu uma oscilação importante de preço.

Cenário 2: Inbox Zero

Tenho um amigo que trabalha com gestão e precisa lidar com mais de cem e-mails por dia. Esta é a configuração dele:

{
  "name": "Email Inbox Monitor",
  "schedule": "0 */2 * * *",
  "skill": "inbox-zero",
  "action": "isolated",
  "prompt": "Conecte-se ao Gmail e verifique os e-mails não lidos. Separe-os por importância em três categorias: urgentes, que exigem ação imediata; importantes, que devem ser tratados hoje; e comuns, que podem ser tratados nesta semana. Prepare sugestões de resposta para os e-mails urgentes.",
  "notify": {
    "channel": "slack",
    "bestEffort": true
  }
}

Pontos principais:

• 0 */2 * * *: verifica a cada duas horas
• Envia o resultado ao canal de trabalho no Slack, o que facilita a colaboração da equipe
• A IA classifica os e-mails e prepara respostas automaticamente, aumentando bastante a eficiência

Cenário 3: inspeção noturna da casa inteligente

Se você tem dispositivos de casa inteligente, este cenário pode ser útil:

{
  "name": "Smart Home Night Check",
  "schedule": "0 23 * * *",
  "skill": "home-security",
  "action": "main",
  "prompt": "Faça a inspeção de segurança noturna: 1) verifique o estado de todos os sensores de portas e janelas 2) confirme que o sistema de segurança está ativado 3) verifique se a temperatura interna está entre 18 e 24 graus 4) confirme que todas as luzes estão apagadas, exceto as luzes noturnas. Notifique imediatamente se houver alguma anomalia.",
  "notify": {
    "channel": "whatsapp"
  }
}

A inspeção é executada automaticamente todas as noites às 23h, e qualquer problema é enviado imediatamente ao WhatsApp. Uso essa tarefa há seis meses, e ela já me avisou duas vezes que uma porta não estava bem trancada.

Cenário 4: monitoramento de repositórios no GitHub

Este cenário pode ser útil para quem programa:

{
  "name": "GitHub Repo Monitor",
  "schedule": "0 10 * * *",
  "skill": "github-monitor",
  "action": "isolated",
  "prompt": "Verifique meus repositórios no GitHub, nesta lista: repo1, repo2 e repo3. Analise: 1) novas Issues 2) novos Pull Requests 3) variação no número de Stars. Crie um resumo diário.",
  "notify": {
    "channel": "telegram",
    "bestEffort": true
  }
}

Todos os dias às 10h, recebo um resumo da atividade no GitHub sem precisar atualizar as páginas manualmente.

Técnicas avançadas e boas práticas

Depois de usar os Cron Jobs do OpenClaw por algum tempo, reuni algumas lições que podem ajudar.

Lista de boas práticas

1. Isole tarefas que geram ruído
Sempre use o modo isolated em monitoramentos frequentes, como os que executam a cada dez minutos. Caso contrário, a conversa principal ficará cheia de mensagens. Cometi esse erro no início: configurei uma tarefa para rodar a cada cinco minutos no modo main, e os logs de monitoramento ocuparam toda a conversa, impedindo o uso normal.

2. Use o modo wake em tarefas críticas
Para tarefas muito sensíveis ao horário, adicione "wake": "now" à configuração. Assim, ela será executada no momento exato, em vez de esperar pelo próximo ciclo de heartbeat.

3. Vincule um Agent específico
Se você configurou vários Agents especializados, como um Agent dedicado a e-mails, use o campo agentId para escolher qual deles executará a tarefa:

{
  "agentId": "email-specialist",
  "name": "Email Monitor",
  ...
}

4. Configure as notificações com critério
Nem toda tarefa precisa enviar uma notificação. Tenho, por exemplo, uma tarefa que faz backup das minhas notas a cada hora; ela só precisa registrar um log. Para tarefas não críticas, recomendo bestEffort: true, evitando que uma falha ocasional de envio afete toda a cadeia.

5. Combine com verificações de heartbeat
O OpenClaw tem um mecanismo de heartbeat que pode verificar determinadas condições periodicamente. Você pode combiná-lo com Cron Jobs para criar acionamentos condicionais mais inteligentes.

Referência rápida da sintaxe Cron

Para ser sincero, no início é difícil memorizar a sintaxe Cron. Reuni abaixo os exemplos mais comuns:

# A cada minuto
* * * * *

# Todos os dias às 9h
0 9 * * *

# Às 17h nos dias úteis, de segunda a sexta-feira
0 17 * * 1-5

# Todo domingo às 20h
0 20 * * 0

# A cada 15 minutos
*/15 * * * *

# No minuto 30 de cada hora
30 * * * *

# Às 2h no primeiro dia de cada mês
0 2 1 * *

# À meia-noite de 1º de janeiro de cada ano
0 0 1 1 *

# A cada hora, das 10h às 18h, todos os dias
0 10-18 * * *

O formato é: minuto hora dia mês dia-da-semana.

Se ainda parecer complicado, use a ferramenta on-line Crontab Guru. Informe o horário desejado, e ela gera a sintaxe automaticamente.

Técnicas de depuração

O que fazer quando uma tarefa não é executada ou produz um resultado incorreto? Pela minha experiência, vale seguir estas etapas:

Acompanhar os logs em tempo real

tail -f ~/.openclaw/logs/cron.log

Esse comando mostra o log de execução das tarefas cron em tempo real, incluindo o horário de acionamento, o resultado e as mensagens de erro de cada tarefa.

Railway - Plataforma de deploy moderna, sem ops complexas, no ar em minutos

Começar agora →Anúncio

Verificar o estado da tarefa

openclaw cron status "Morning Brief"

Veja o estado detalhado de uma tarefa específica, incluindo a última execução, o próximo horário agendado e a taxa de sucesso.

Acionar manualmente com depuração ativada

openclaw cron run "Morning Brief" --now --debug

O parâmetro --debug exibe o processo de execução em detalhes, inclusive as etapas de raciocínio da IA e as chamadas de API.

Validar a sintaxe Cron
Se você suspeitar de um problema na configuração do horário, use uma ferramenta on-line, como o crontab.guru, para validar a sintaxe.

Recomendações de segurança

As tarefas agendadas do OpenClaw podem envolver operações sensíveis. Considere estas recomendações:

1. Evite armazenar credenciais em texto simples
Se a tarefa precisa acessar um serviço de terceiros, como Gmail ou uma API de ações, não grave a chave de API diretamente no arquivo de configuração. Prefira uma variável de ambiente:

{
  "prompt": "Use a variável de ambiente $GMAIL_API_KEY para se conectar ao Gmail..."
}

2. Revise os logs de execução regularmente
De tempos em tempos, verifique o diretório ~/.openclaw/logs/ para identificar execuções anormais. Toda sexta-feira, reservo cinco minutos para essa revisão.

3. Configure notificações de falha
Para tarefas importantes, vale configurar alertas de falha:

{
  "notify": {
    "onFailure": true,
    "channel": "telegram"
  }
}

Assim, você fica sabendo imediatamente quando a execução falhar.

4. Aplique o princípio do menor privilégio
Se uma tarefa precisa apenas de acesso de leitura, não conceda permissão de escrita. O OpenClaw oferece controle granular de permissões; use-o com cuidado.

Considerações finais

Para ser sincero, configurar Cron Jobs no OpenClaw mudou completamente a maneira como uso assistentes de IA. Antes, eu tratava a IA como uma “ferramenta passiva”, acionada apenas quando necessário. Agora ela se parece mais com uma “parceira proativa”, capaz de reconhecer por conta própria quando determinada tarefa precisa ser feita.

A passagem da resposta reativa para a execução proativa não é apenas mais um recurso técnico; ela representa uma evolução no papel do assistente de IA. Você não precisa mais lembrar quais perguntas deve fazer todos os dias nem se preocupar em esquecer verificações importantes — a IA cuida dessas tarefas no momento adequado.

Se você ainda não experimentou os Cron Jobs do OpenClaw, recomendo começar por um cenário simples, como o boletim matinal diário. A configuração leva menos de cinco minutos, mas os ganhos de eficiência permanecem no longo prazo.

Hoje tenho cerca de uma dúzia de tarefas agendadas para trabalho, vida pessoal, investimentos e outras áreas. Quando acordo, as informações importantes já estão organizadas no celular; durante o trabalho, não preciso trocar constantemente de janela para conferir e-mails e mensagens; antes de dormir, a inspeção de segurança da casa também é concluída automaticamente. O resultado é concreto: a IA não fica esperando uma ordem, mas assume tarefas repetitivas e necessárias de forma proativa.

Se você encontrar algum problema durante a configuração, consulte a documentação oficial do OpenClaw ou faça uma pergunta na comunidade. Há muita gente disposta a compartilhar configurações e experiências de uso.

Comece agora a configurar sua primeira tarefa agendada. A partir de amanhã, deixe a IA trabalhar de forma proativa para você.

Fontes de referência:

• Documentação oficial do OpenClaw
• Gerador de sintaxe Cron
• OpenClaw GitHub Discussions (para conversas da comunidade, consulte a área Discussions do repositório)
• Tutorial de integração do OpenClaw com o Telegram