Uma extensão de execução de script em segundo plano agendada que executa comandos bash diretamente via hook de gateway do OpenClaw com hot-reloading e custo zero de LLM.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install cron-scripts
2. Instalação Manual
Copie a pasta da habilidade para um desses locais
~/.openclaw/skills/ <project>/skills/ Prioridade: Espaço de Trabalho > Local > Integrado
3. Instalação do Prompt
Copie este prompt para o OpenClaw para instalá-lo automaticamente.
Ajude-me a instalar o cron-scripts usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).
Prefere baixar?
Obtenha os arquivos originais da habilidade em um arquivo ZIP.
O que é Cron Scripts?
A extensão cron-scripts é um utilitário altamente eficiente projetado para agendar e executar scripts shell padrão sem envolver modelos de linguagem caros. No ecossistema do Openclaw Skills, esta ferramenta serve como uma solução de alto desempenho para executar processos em segundo plano, como limpezas de sistema, notificações locais ou atualizações de Git. Ela aproveita a arquitetura de Gateway subjacente para carregar scripts personalizados na inicialização, tornando-a perfeita para tarefas que não exigem raciocínio cognitivo.
Ao evitar turnos desnecessários de agentes LLM, o cron-scripts garante custo zero de uso de API enquanto mantém um diretório unificado de automação de scripts. Com recursos integrados como hot-reloads automatizados em milissegundos, este sistema garante que você possa implantar rapidamente verificações de sistema e etapas de automação diretamente em seu ambiente sem tempo de inatividade.
Casos de uso do Cron Scripts
- Automatizar manutenção recorrente do sistema, como backups de banco de dados, git pulls e tarefas de limpeza de arquivos.
- Executar verificações rotineiras de infraestrutura, HTTP health pings e rastreamento de daemon interno.
- Enviar notificações estáticas, alertas ou webhooks de sistema diretamente para endpoints de Telegram ou Slack.
- Monitorar diretórios específicos do sistema em busca de alterações e executar scripts sem disparar etapas de agente.
- Descarregar tarefas repetitivas de script para economizar tokens de LLM e reduzir a sobrecarga operacional.
Como o Cron Scripts funciona
- Ativação de Hook do Gateway: Durante a inicialização, o gateway do OpenClaw carrega o manipulador de hook de inicialização, inicializando o motor cron.
- Monitoramento de Diretório: O sistema verifica e monitora automaticamente o diretório de scripts designado (
~/.openclaw/cron-scripts/). - Extração de Configuração Frontmatter: O carregador lê as primeiras 20 linhas de cada arquivo
.shexecutável para analisar agendamentos de execução, nomes, configurações de fuso horário e limites de tempo limite. - Inscrição no Agendador: Usando a biblioteca Node.js
cronerincluída, o hook registra temporizadores de tarefa na memória, garantindo que as tarefas sejam protegidas contra execução simultânea se uma execução anterior estiver ativa. - Hot-Reloading e Execução: O monitor rastreia atualizações do sistema de arquivos dinamicamente. Modificar ou excluir um script aplica as atualizações dentro de 300ms sem exigir reinicialização do gateway.
Configuração do Cron Scripts
1. Instalar o Hook do Gateway
Crie a pasta de destino dentro da sua estrutura local do OpenClaw e copie o código do manipulador do carregador para o local:
mkdir -p ~/.openclaw/hooks/cron-scripts-loader
cp hooks/cron-scripts-loader/handler.ts ~/.openclaw/hooks/cron-scripts-loader/handler.ts
Reinicie o gateway para habilitar o registro do hook:
openclaw gateway restart
2. Preparar o Diretório de Scripts
Configure o espaço de trabalho onde seus scripts serão armazenados:
mkdir -p ~/.openclaw/cron-scripts
3. Criar uma Tarefa Agendada
Escreva um script bash básico com os metadados necessários no cabeçalho do script. Salve-o dentro do seu diretório de cron script personalizado:
#!/usr/bin/env bash
# name: ping-health
# schedule: */5 * * * *
# tz: UTC
# timeout: 60
curl -sf https://hc-ping.com/your-uuid-here || echo "Ping failed!"
Conceda privilégios de execução ao script para que o executor possa acioná-lo:
chmod +x ~/.openclaw/cron-scripts/ping-health.sh
Esquema de Dados e Taxonomia de Cron Scripts
Configuração de Metadados de Script
Cada cron script deve configurar seus metadados diretamente dentro do cabeçalho usando um formato frontmatter nas primeiras 20 linhas do arquivo:
| Atributo | Tipo Esperado | Obrigatório | Descrição | Valor Padrão |
|---|---|---|---|---|
name |
String | Sim | Rótulo para identificar a execução da tarefa em seus arquivos de log | N/A |
schedule |
String | Sim | Uma expressão clássica de configuração cron de 5 campos | N/A |
tz |
String | Não | Designação válida do banco de dados de fuso horário IANA | UTC |
timeout |
Number | Não | Limite rígido de tempo limite em segundos antes da terminação SIGTERM | 120 |
Formato de Logs e Rastreamento
Os detalhes do processo são mapeados diretamente para as saídas do gateway do sistema. Cada operação mapeia claramente para logs de telemetria padrão:
- Status de Inicialização:
[cron-scripts-loader][<name>] Starting run - Encaminhamento de STDOUT:
[cron-scripts-loader][<name>] <line-output> - Resultado da Terminação:
[cron-scripts-loader][<name>] Finished ok (exit 0)
Recursos avançados do Cron Scripts
- Hot Reloading Sub-segundo: Emprega um monitor de diretório inteligente para adicionar, suspender (alterando a extensão para
.disabled) ou excluir tarefas dinamicamente com segurança dentro de ~300ms. - Interoperabilidade Direta de Notificação API: Scripts podem se comunicar usando loops locais com o endpoint de anúncio da api do gateway (
http://localhost:3000/api/announce) para solicitar anúncios push multicanal instantâneos. - Guarda de Concorrência: Executa com salvaguardas de execução integradas (
protect: true) garantindo que sobreposições sejam graciosamente evitadas durante scripts shell intensivos de longa execução. - Execução Direta de Dependência Node: Opera diretamente com a biblioteca
cronerjá incluída nos node_modules do sistema host, eliminando a necessidade de requisitos de instalação externa.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
Arabic Flashcard Maker Skill
Um sistema alimentado por IA para transformar notas, vocabulário e pontos gramaticais em árabe em flashcards prontos para estudo e quizzes interativos.
Skill de Detecção de Malware SAS do Alibaba Cloud
Um scanner automatizado de arquivos e diretórios maliciosos alimentado pelas APIs do SDK do Alibaba Cloud Security Center (SAS).
Toolkit de Sabedoria de A Última Aula
Um toolkit de sabedoria de vida e aceitação da morte que integra as 14 lições de terça-feira de Morrie Schwartz sobre amor, trabalho, família, envelhecimento e dignidade em ambientes de conversação.
Detect AI Flavor
Uma skill de análise de conteúdo bilíngue projetada para detectar padrões de escrita gerados por IA e restaurar o calor humano ao seu texto.
Skill de Ativismo Ambiental Silent Spring
Um kit de ferramentas interativo de ciência ambiental e ativismo ecológico projetado para educar os usuários sobre bioacumulação de pesticidas, resistência química e métodos naturais de controle de pragas.
Football Data Hub
Uma ferramenta de consulta de banco de dados de futebol com configuração zero que recupera classificações em tempo real, jogos, estatísticas de jogadores e análises históricas de confrontos diretos.
Apresentou*
