SKILL.md — Axioma Safe Cron Creator

Version: 3.0.0

Author: Axioma Cluster

Date: 2026-05-22

Status: PRODUCTION ✅

Target Score: 90%+

Concept

Ce skill crée des crons système qui exécutent des scripts Python directement, sans passer par OpenClaw agent session. Cela évite le bug EmbeddedAttemptSessionTakeoverError qui cause des collisions avec les sessions Telegram.

The Problem

OpenClaw cron (agentTurn)
    ↓
Crée une session dans /agents/main/sessions/
    ↓
Pendant exécution, le fichier session est modifié par autre chose (Telegram, autre cron, etc.)
    ↓
Session lock released → session file changed → EmbeddedAttemptSessionTakeoverError ❌

The Solution

System cron (crontab -e)
    ↓
Exécute /usr/bin/python3 directement
    ↓
No OpenClaw session involvement
    ↓
No collision ✅

Architecture

┌─────────────────────────────────────────────────────┐
│                   USER REQUEST                        │
│  "Crée un cron pour script X"                        │
└─────────────────────┬───────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────┐
│           SAFE CRON CREATOR SKILL                    │
│                                                      │
│  1. Validate script path (exists + executable)        │
│  2. Generate unique cron expression                  │
│  3. Create wrapper Python script (optional)           │
│  4. Add to system crontab (crontab -e)              │
│  5. Log creation to /home/axioma/.openclaw/logs/    │
│  6. Verify cron installed                            │
│  7. Return cron metadata                             │
└─────────────────────┬───────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────┐
│              SYSTEM CRON (crontab)                   │
│                                                      │
│  • No OpenClaw session involvement                   │
│  • No Telegram collision                             │
│  • Direct Python execution                           │
│  • Persistent across reboots                         │
└─────────────────────────────────────────────────────┘

Tools

Script Principal

Available Commands

# CRÉER un cron isolé
python3 /home/axioma/.openclaw/scripts/safe_cron_creator.py create \
  --script <path> \
  --schedule "<cron>" \
  [--wrapper <path>] \
  [--label <name>] \
  [--log <path>]


# LISTER tous les cronssafe
python3 /home/axioma/.openclaw/scripts/safe_cron_creator.py list


# VÉRIFIER un cron (status + logs)
python3 /home/axioma/.openclaw/scripts/safe_cron_creator.py verify --label <name>

# SUPPRIMER un cron
python3 /home/axioma/.openclaw/scripts/safe_cron_creator.py remove --label <name>

Automatic Validation (Cron Evaluator)

Après création d'un cron, le skill peut automatiquement:

1. Scanner les collisions temporelles
2. Évaluer la signature ressource (RAM/CPU)
3. Vérifier la résilience (logs, timeout, flock)
4. Suggérer des optimisations (jitter, systemd migration)

# Évaluation automatique post-création
python3 /mnt/Morgana/skills/cron-evaluator/scripts/cron_evaluator_v3.py --scan

# Health check
python3 /mnt/Morgana/skills/cron-evaluator/scripts/cron_evaluator_v3.py --health

# Suggérer optimisations
python3 /mnt/Morgana/skills/cron-evaluator/scripts/cron_evaluator_v3.py --suggest

Les 4 Piliers du Cron Evaluator

Auto-Amélioration

Si le cron créé a un score < 0.7, le skill suggère:

• Jitter si collision temporelle: sleep $((RANDOM % 60))
• Timeout si script long: timeout 600
• Flock si accès concurrent: flock -n /tmp/lock.lock
• Logging si pas de log: redirection vers fichier

Prerequisites