Tarefas Cron do Clawdbot

Agende tarefas automatizadas com as tarefas cron do assistente de IA Clawdbot. Aprenda a configurar mensagens recorrentes, relatórios e fluxos de trabalho automatizados.

Visão geral das tarefas Cron do Clawdbot

O Clawdbot suporta tarefas agendadas usando sintaxe estilo cron. As tarefas cron permitem mensagens automatizadas, relatórios periódicos, verificações de saúde e fluxos de trabalho recorrentes.

Configuração

Tarefa Cron básica

{
  "cron": {
    "jobs": [
      {
        "id": "daily-summary",
        "schedule": "0 9 * * *",
        "action": "send_message",
        "target": {
          "channel": "whatsapp",
          "peer": "+15551234567"
        },
        "message": "Good morning! Here's your daily summary."
      }
    ]
  }
}

Sintaxe Cron

CampoValoresDescrição
Minuto0-59Minuto da hora
Hora0-23Hora do dia
Dia1-31Dia do mês
Mês1-12Mês do ano
Dia da semana0-6Dia da semana (0=Domingo)

Agendamentos comuns

AgendamentoExpressão Cron
A cada hora0 * * * *
Diário às 9h0 9 * * *
Semanal segunda-feira0 9 * * 1
Mensal dia 10 9 1 * *

Tipos de tarefas

Tarefas de mensagens

Enviar mensagens agendadas:

{
  "id": "reminder",
  "schedule": "0 8 * * 1-5",
  "action": "send_message",
  "target": {
    "channel": "telegram",
    "peer": "123456789"
  },
  "message": "Start of workday reminder!"
}

Tarefas de agente

Executar tarefas de agente:

{
  "id": "daily-report",
  "schedule": "0 18 * * *",
  "action": "run_agent",
  "agentId": "reporter",
  "prompt": "Generate today's activity report"
}

Tarefas Webhook

Acionar webhooks:

{
  "id": "health-check",
  "schedule": "*/5 * * * *",
  "action": "webhook",
  "url": "https://api.example.com/health",
  "method": "POST"
}

Gerenciamento de sessões

Chaves de sessão Cron

As tarefas cron usam sessões dedicadas:

cron:<job.id>

Isolamento de sessões

  • Cada tarefa tem sua própria sessão
  • O histórico persiste entre execuções
  • O contexto é mantido

Gerenciamento de tarefas

Comandos CLI

# Listar tarefas cron
clawdbot cron list

# Adicionar uma tarefa
clawdbot cron add --id daily --schedule "0 9 * * *" --action send_message

# Remover uma tarefa
clawdbot cron remove daily

# Executar tarefa imediatamente
clawdbot cron run daily

Status da tarefa

StatusDescrição
activeA tarefa está agendada
pausedA tarefa está pausada
runningExecutando atualmente
failedA última execução falhou

Tratamento de erros

Política de retry

{
  "cron": {
    "retry": {
      "maxAttempts": 3,
      "backoff": "exponential",
      "initialDelay": 1000
    }
  }
}

Notificações de falha

{
  "cron": {
    "notifications": {
      "onFailure": {
        "channel": "telegram",
        "peer": "admin_id"
      }
    }
  }
}

Fuso horário

Configuração

{
  "cron": {
    "timezone": "Asia/Shanghai"
  }
}

Comportamento padrão

  • Usa o fuso horário do sistema se não especificado
  • Todos os agendamentos são interpretados no fuso horário configurado

Exemplos

Lembrete de standup diário

{
  "id": "standup",
  "schedule": "0 9 * * 1-5",
  "action": "send_message",
  "target": {
    "channel": "discord",
    "peer": { "kind": "group", "id": "standup-channel" }
  },
  "message": "Time for daily standup! What did you work on yesterday?"
}

Relatório semanal

{
  "id": "weekly-report",
  "schedule": "0 17 * * 5",
  "action": "run_agent",
  "agentId": "main",
  "prompt": "Generate weekly summary report and send to team channel"
}

Próximos passos