Una extensión de ejecución de scripts en segundo plano programada que ejecuta comandos bash directamente a través de un hook de gateway de OpenClaw con hot-reloading y coste cero de LLM.
Instalar y Descargar
1. ClawHub CLI
La forma más rápida de instalar una habilidad directamente desde el registro.
npx clawhub@latest install cron-scripts
2. Instalación manual
Copia la carpeta de la habilidad a una de estas ubicaciones
~/.openclaw/skills/ <project>/skills/ Prioridad: Espacio de trabajo > Local > Integrado
3. Instalación del prompt
Copia este prompt en OpenClaw para instalarlo automáticamente.
Ayúdame a instalar cron-scripts usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).
¿Prefieres descargar?
Obtén los archivos originales de la habilidad en un archivo ZIP.
¿Qué es Cron Scripts?
La extensión cron-scripts es una utilidad altamente eficiente diseñada para programar y ejecutar scripts de shell estándar sin involucrar costosos modelos de lenguaje. En el ecosistema de Openclaw Skills, esta herramienta sirve como una solución de alto rendimiento para ejecutar procesos en segundo plano, como limpiezas del sistema, notificaciones locales o actualizaciones de Git. Aprovecha la arquitectura subyacente de Gateway para cargar scripts personalizados al inicio, lo que la hace perfecta para tareas que no requieren razonamiento cognitivo.
Al evitar turnos innecesarios de agentes LLM, cron-scripts garantiza un coste de uso de API de cero mientras mantiene un directorio unificado de automatización de scripts. Con características integradas como hot-reloads automatizados en milisegundos, este sistema garantiza que pueda implementar rápidamente comprobaciones del sistema y pasos de automatización directamente dentro de su entorno sin tiempo de inactividad.
Casos de uso de Cron Scripts
- Automatización de mantenimiento recurrente del sistema, como copias de seguridad de bases de datos, git pulls y tareas de limpieza de archivos.
- Ejecución de comprobaciones rutinarias de infraestructura, pings de salud HTTP y seguimiento de demonios internos.
- Envío de notificaciones estáticas, alertas o webhooks del sistema directamente a puntos finales de Telegram o Slack.
- Supervisión de directorios específicos del sistema en busca de cambios y ejecución de scripts sin activar pasos de agente.
- Descarga de tareas repetitivas de scripting para ahorrar tokens de LLM y reducir la sobrecarga operativa.
Cómo funciona Cron Scripts
- Activación de Hook de Gateway: Durante la inicialización, el gateway de OpenClaw carga el controlador de hook de inicio, inicializando el motor cron.
- Supervisión de directorios: El sistema escanea y supervisa automáticamente el directorio de scripts designado (
~/.openclaw/cron-scripts/). - Extracción de configuración Frontmatter: El cargador lee las primeras 20 líneas de cada archivo
.shejecutable para analizar los programas de ejecución, nombres, configuraciones de zona horaria y límites de tiempo de espera. - Inscripción en el programador: Utilizando la biblioteca Node.js
cronerincluida, el hook registra temporizadores de tareas en la memoria, asegurando que las tareas estén protegidas contra la ejecución simultánea si una ejecución anterior está activa. - Hot-Reloading y Ejecución: El monitor rastrea las actualizaciones del sistema de archivos de forma dinámica. Modificar o eliminar un script aplica las actualizaciones en 300ms sin requerir un reinicio del gateway.
Configuración de Cron Scripts
1. Instalar el Hook de Gateway
Cree la carpeta de destino dentro de su estructura local de OpenClaw y copie el código del controlador del cargador al lugar:
mkdir -p ~/.openclaw/hooks/cron-scripts-loader
cp hooks/cron-scripts-loader/handler.ts ~/.openclaw/hooks/cron-scripts-loader/handler.ts
Reinicie el gateway para habilitar el registro del hook:
openclaw gateway restart
2. Preparar el directorio de scripts
Configure el espacio de trabajo donde se alojarán sus scripts:
mkdir -p ~/.openclaw/cron-scripts
3. Crear una tarea programada
Escriba un script bash básico con los metadatos requeridos en el encabezado del script. Guárdelo dentro de su directorio 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 privilegios de ejecución al script para que el ejecutor pueda activarlo:
chmod +x ~/.openclaw/cron-scripts/ping-health.sh
Esquema de datos y taxonomía de Cron Scripts
Configuración de metadatos de script
Cada cron script debe configurar sus metadatos directamente dentro del encabezado utilizando un formato frontmatter en las primeras 20 líneas del archivo:
| Atributo | Tipo esperado | Requerido | Descripción | Valor predeterminado |
|---|---|---|---|---|
name |
String | Sí | Etiqueta para identificar la ejecución de la tarea en sus archivos de registro | N/A |
schedule |
String | Sí | Una expresión clásica de configuración cron de 5 campos | N/A |
tz |
String | No | Designación válida de la base de datos de zonas horarias IANA | UTC |
timeout |
Number | No | Límite rígido de tiempo de espera en segundos antes de la terminación SIGTERM | 120 |
Formato de registros y seguimiento
Los detalles del proceso se asignan directamente a las salidas del gateway del sistema. Cada operación se asigna claramente a los registros de telemetría estándar:
- Estado de inicio:
[cron-scripts-loader][<name>] Starting run - Reenvío de STDOUT:
[cron-scripts-loader][<name>] <line-output> - Resultado de terminación:
[cron-scripts-loader][<name>] Finished ok (exit 0)
Funciones avanzadas de Cron Scripts
- Hot Reloading Sub-segundo: Emplea un monitor de directorio inteligente para agregar, suspender (cambiando la extensión a
.disabled) o eliminar tareas de forma dinámica y segura en ~300ms. - Interoperabilidad directa de notificación API: Los scripts pueden comunicarse utilizando bucles locales con el punto final de anuncio de la api del gateway (
http://localhost:3000/api/announce) para solicitar anuncios push multicanal instantáneos. - Protección de concurrencia: Se ejecuta con salvaguardias de ejecución integradas (
protect: true) asegurando que las superposiciones se eviten con gracia durante scripts de shell intensivos de larga duración. - Ejecución directa de dependencia Node: Opera directamente con la biblioteca
cronerya incluida en los node_modules del sistema host, eliminando la necesidad de requisitos de instalación externos.
SKILL.md
Cargando
Habilidades relacionadas de Openclaw
Arabic Flashcard Maker Skill
Un sistema basado en IA para convertir notas, vocabulario y puntos gramaticales en árabe en flashcards listos para estudiar y cuestionarios interactivos.
Skill de Detección de Malware SAS de Alibaba Cloud
Un escáner automatizado de archivos y directorios maliciosos impulsado por las API del SDK de Alibaba Cloud Security Center (SAS).
Kit de herramientas de sabiduría de Martes con mi viejo profesor
Un kit de herramientas de sabiduría vital y aceptación de la muerte que integra las 14 lecciones de los martes de Morrie Schwartz sobre el amor, el trabajo, la familia, el envejecimiento y la dignidad en entornos conversacionales.
Detect AI Flavor
Una skill de análisis de contenido bilingüe diseñada para detectar patrones de escritura generados por IA y restaurar la calidez humana en tu texto.
Skill de Activismo Ambiental Silent Spring
Un conjunto de herramientas interactivo de ciencia ambiental y activismo ecológico diseñado para educar a los usuarios sobre la bioacumulación de pesticidas, la resistencia química y los métodos naturales de control de plagas.
Football Data Hub
Una herramienta de consulta de base de datos de fútbol de configuración cero que recupera clasificaciones en tiempo real, partidos, estadísticas de jugadores y análisis históricos de enfrentamientos directos.
Presentado*
