Une extension d'exécution de script en arrière-plan planifiée qui exécute des commandes bash directement via un hook de gateway OpenClaw avec hot-reloading et coût LLM zéro.
Installer & Télécharger
1. ClawHub CLI
Le moyen le plus rapide d'installer une compétence directement depuis le registre.
npx clawhub@latest install cron-scripts
2. Installation manuelle
Copiez le dossier de la compétence dans l'un de ces emplacements
~/.openclaw/skills/ <project>/skills/ Priorité : Espace de travail > Local > Intégré
3. Installation du prompt
Copiez ce prompt dans OpenClaw pour l'installer automatiquement.
Aide-moi à installer cron-scripts via Clawhub. Si Clawhub n'est pas installé, installe-le d'abord (npm i -g clawhub).
Vous préférez télécharger ?
Obtenez les fichiers bruts de la compétence dans une archive ZIP.
Qu'est-ce que Cron Scripts ?
L'extension cron-scripts est un utilitaire hautement efficace conçu pour planifier et exécuter des scripts shell standard sans impliquer de modèles de langage coûteux. Dans l'écosystème Openclaw Skills, cet outil sert de solution de contournement haute performance pour exécuter des processus en arrière-plan tels que le nettoyage du système, les notifications locales ou les mises à jour Git. Il tire parti de l'architecture Gateway sous-jacente pour charger des scripts personnalisés au démarrage, ce qui le rend parfait pour les tâches qui ne nécessitent pas de raisonnement cognitif.
En évitant les tours d'agent LLM inutiles, cron-scripts garantit un coût d'utilisation de l'API nul tout en maintenant un répertoire unifié d'automatisation de scripts. Avec des fonctionnalités intégrées telles que les hot-reloads automatisés en millisecondes, ce système garantit que vous pouvez déployer rapidement des vérifications système et des étapes d'automatisation directement dans votre environnement sans interruption.
Cas d'utilisation de Cron Scripts
- Automatisation de la maintenance système récurrente telle que les sauvegardes de base de données, les git pulls et les tâches de nettoyage de fichiers.
- Exécution de vérifications d'infrastructure de routine, de pings de santé HTTP et de suivi interne des démons.
- Envoi de notifications statiques, d'alertes ou de webhooks système directement vers des endpoints Telegram ou Slack.
- Surveillance de répertoires système spécifiques pour les changements et exécution de scripts sans déclencher d'étapes d'agent.
- Déchargement des tâches de script répétitives pour économiser des jetons LLM et réduire la surcharge opérationnelle.
Comment fonctionne Cron Scripts
- Activation du Hook de Gateway : Pendant l'initialisation, la gateway OpenClaw charge le gestionnaire de hook de démarrage, initialisant le moteur cron.
- Surveillance de répertoire : Le système scanne et surveille automatiquement le répertoire de scripts désigné (
~/.openclaw/cron-scripts/). - Extraction de configuration Frontmatter : Le chargeur lit les 20 premières lignes de chaque fichier
.shexécutable pour analyser les programmes d'exécution, les noms, les configurations de fuseau horaire et les limites de timeout. - Inscription au planificateur : En utilisant la bibliothèque Node.js
cronerincluse, le hook enregistre des minuteurs de tâches en mémoire, garantissant que les tâches sont protégées contre l'exécution simultanée si une exécution précédente est active. - Hot-Reloading et exécution : Le moniteur suit dynamiquement les mises à jour du système de fichiers. La modification ou la suppression d'un script applique les mises à jour dans les 300ms sans nécessiter de redémarrage de la gateway.
Configuration de Cron Scripts
1. Installer le Hook de Gateway
Créez le dossier cible à l'intérieur de votre structure locale OpenClaw et copiez le code du gestionnaire de chargement à l'emplacement approprié :
mkdir -p ~/.openclaw/hooks/cron-scripts-loader
cp hooks/cron-scripts-loader/handler.ts ~/.openclaw/hooks/cron-scripts-loader/handler.ts
Redémarrez la gateway pour activer l'enregistrement du hook :
openclaw gateway restart
2. Préparer le répertoire de scripts
Configurez l'espace de travail où vos scripts seront hébergés :
mkdir -p ~/.openclaw/cron-scripts
3. Créer une tâche planifiée
Écrivez un script bash de base avec les métadonnées requises dans l'en-tête du script. Enregistrez-le dans votre répertoire de script cron personnalisé :
#!/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!"
Accordez les privilèges d'exécution au script afin que l'exécuteur puisse le déclencher :
chmod +x ~/.openclaw/cron-scripts/ping-health.sh
Schéma de données et taxonomie de Cron Scripts
Configuration des métadonnées de script
Chaque script cron doit configurer ses métadonnées directement dans l'en-tête en utilisant un format frontmatter dans les 20 premières lignes du fichier :
| Attribut | Type attendu | Requis | Description | Valeur par défaut |
|---|---|---|---|---|
name |
String | Oui | Étiquette pour identifier l'exécution de la tâche dans vos fichiers journaux | N/A |
schedule |
String | Oui | Une expression classique de configuration cron à 5 champs | N/A |
tz |
String | Non | Désignation valide de la base de données de fuseaux horaires IANA | UTC |
timeout |
Number | Non | Limite stricte de timeout en secondes avant la terminaison SIGTERM | 120 |
Format des journaux et du traçage
Les détails du processus sont mappés directement sur les sorties de la gateway système. Chaque opération est clairement mappée sur les journaux de télémétrie standard :
- Statut de démarrage :
[cron-scripts-loader][<name>] Starting run - Transfert STDOUT :
[cron-scripts-loader][<name>] <line-output> - Résultat de terminaison :
[cron-scripts-loader][<name>] Finished ok (exit 0)
Fonctionnalités avancées de Cron Scripts
- Hot Reloading en moins d'une seconde : Emploie un moniteur de répertoire intelligent pour ajouter, suspendre (en changeant l'extension en
.disabled) ou supprimer des tâches dynamiquement en toute sécurité en ~300ms. - Interopérabilité directe de notification API : Les scripts peuvent communiquer en utilisant des boucles locales avec l'endpoint d'annonce de l'api de la gateway (
http://localhost:3000/api/announce) pour déclencher des annonces push multicanaux instantanées. - Garde de concurrence : Fonctionne avec des protections d'exécution intégrées (
protect: true) garantissant que les chevauchements sont évités gracieusement lors de scripts shell intensifs de longue durée. - Exécution directe de dépendance Node : Fonctionne directement avec la bibliothèque
cronerdéjà incluse dans les node_modules du système hôte, éliminant le besoin d'exigences d'installation externes.
SKILL.md
Chargement
Compétences Openclaw associées
Arabic Flashcard Maker Skill
Un système alimenté par IA pour transformer des notes en arabe, du vocabulaire et des points de grammaire en flashcards et quiz interactifs prêts à l'emploi.
Skill de détection de logiciels malveillants SAS d'Alibaba Cloud
Un scanner automatisé de fichiers et répertoires malveillants alimenté par les API du SDK d'Alibaba Cloud Security Center (SAS).
Boîte à outils de sagesse de Mardi avec Morrie
Une boîte à outils de sagesse de vie et d'acceptation de la mort intégrant les 14 leçons du mardi de Morrie Schwartz sur l'amour, le travail, la famille, le vieillissement et la dignité dans des environnements conversationnels.
Detect AI Flavor
Une skill d'analyse de contenu bilingue conçue pour détecter les modèles d'écriture générés par IA et restaurer la chaleur humaine dans votre texte.
Skill d'activisme environnemental Silent Spring
Un ensemble d'outils interactifs sur la science environnementale et l'activisme écologique conçu pour sensibiliser les utilisateurs à la bioaccumulation des pesticides, à la résistance chimique et aux méthodes naturelles de lutte contre les nuisibles.
Football Data Hub
Un outil de requête de base de données de football sans configuration qui récupère les classements en temps réel, les matchs, les statistiques des joueurs et les analyses historiques des face-à-face.
METADATA
En vedette*
