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 \x3Cpath> \
  --schedule "\x3Ccron>" \
  [--wrapper \x3Cpath>] \
  [--label \x3Cname>] \
  [--log \x3Cpath>]


# 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 \x3Cname>

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

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 \x3C 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

Vérification des Prerequisites

# Vérifier Python
python3 --version  # Devrait afficher Python 3.x.x

# Vérifier crontab
which crontab  # Devrait afficher /usr/bin/crontab ou similaire

# Vérifier permissions
crontab -l  # Devrait lister les crons actuels sans erreur

Constraints (CRITICAL)

Constraints de Sécurité

Constraints Techniques

Detailed Usage

Create a simple cron

SKILL: safe-cron-creator
ACTION: create
SCRIPT: /path/to/script.py
SCHEDULE: "0 * * * *"  # every hour at minute 0
LOG: /path/to/logfile.log

Résultat:

✅ Cron 'script' created successfully. UUID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Create a cron with wrapper (extractor + store)

SKILL: safe-cron-creator
ACTION: create
SCRIPT: /path/to/extractor.py
WRAPPER: /path/to/store.py
SCHEDULE: "0 * * * *"
LABEL: my_extraction
LOG: /path/to/log.log

Résultat:

✅ Wrapper generated: /home/axioma/.openclaw/scripts/safe_cron_my_extraction_wrapper.py
✅ Cron 'my_extraction' installed

Verify a cron

SKILL: safe-cron-creator
ACTION: verify
LABEL: morgana_l7

Résultat:

✅ Cron active. Last log: [2026-05-22 18:00:00] === Cron Wrapper: morgana_l7 ===

Generated Script (Wrapper)

Le skill génère un wrapper Python qui:

1. Exécute le script principal avec timeout
2. Log avec timestamp précis
3. Gère les erreurs (return code)
4. Exécute le wrapper (optionnel) si le main réussit

#!/usr/bin/env python3
"""Auto-generated cron wrapper"""
import subprocess
import sys
from datetime import datetime

LOG_FILE = "/path/to/log.log"

def log(msg):
    ts = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
    with open(LOG_FILE, "a") as f:
        f.write(f"[{ts}] {msg}\
")

def run_script(path, label):
    log(f"=== Starting {label} ===")
    try:
        result = subprocess.run(
            ["python3", path],
            capture_output=True,
            text=True,
            timeout=600
        )
        if result.returncode == 0:
            log(f"✅ {label} completed")
            return True
        else:
            log(f"❌ {label} failed (code {result.returncode})")
            return False
    except Exception as e:
        log(f"❌ {label} error: {e}")
        return False

def main():
    log("=== Cron Wrapper Started ===")
    # ... execute scripts ...
    return 0

if __name__ == "__main__":
    sys.exit(main())

Edge Cases

Complete Examples

Exemple 1: Morgana L7 Extraction (Production)

python3 /home/axioma/.openclaw/scripts/safe_cron_creator.py create \
  --script "/mnt/Morgana/Axioma Projects/L7_MORGANA/scripts/l7_extractor_morgana.py" \
  --wrapper "/mnt/Morgana/Axioma Projects/L7_MORGANA/scripts/l7_store_morgana.py" \
  --schedule "5 * * * *" \
  --label morgana_l7 \
  --log /mnt/Morgana/memory/episodic/last_cron_l7.log

Logs résultats:

[2026-05-22 18:05:00] === Cron Wrapper: morgana_l7 ===
[2026-05-22 18:05:00] === Starting morgana_l7_main ===
[2026-05-22 18:05:12] ✅ l7_extractor_morgana.py completed
[2026-05-22 18:05:12] === Starting morgana_l7_store ===
[2026-05-22 18:05:23] ✅ l7_store_morgana.py completed
[2026-05-22 18:05:23] === ✅ morgana_l7 Complete ===

Exemple 2: Ezekiel L7 Extraction (Production)

python3 /home/axioma/.openclaw/scripts/safe_cron_creator.py create \
  --script /home/axioma/.openclaw/skills/holistic-memory-system/scripts/l7_extractor.py \
  --wrapper /home/axioma/.openclaw/skills/holistic-memory-system/scripts/l7_store.py \
  --schedule "0 * * * *" \
  --label ezekiel_l7 \
  --log /home/axioma/.openclaw/logs/ezekiel_l7_cron.log

Exemple 3: Vérification et Débogage

# Vérifier status
python3 /home/axioma/.openclaw/scripts/safe_cron_creator.py verify --label morgana_l7

# Lister tous les crons
python3 /home/axioma/.openclaw/scripts/safe_cron_creator.py list

# Lire les logs
tail -20 /mnt/Morgana/memory/episodic/last_cron_l7.log

# Supprimer si besoin
python3 /home/axioma/.openclaw/scripts/safe_cron_creator.py remove --label morgana_l7

Generated Files

Post-Creation Verification

1. crontab -l | grep \x3Clabel> — Confirme installation
2. Lecture du log après premier run
3. Vérification que le script s'exécute sans erreur
4. Vérification que le cron next run est correct

Validation Checklist

Axioma Stellaris Cluster Integration

L9 Integration

Pour ajouter un cron en L9 Deep Memory:

1. Créer le cron avec safe-cron-creator
2. Vérifier qu'il fonctionne
3. Informer Merlin pour ajouter au L9 API

Errors and Solutions

Security and Isolation

Why not OpenClaw cron?

Problème: OpenClaw cron utilise agentTurn
→ Crée session dans /agents/main/sessions/
→ Session lock + file change = EmbeddedAttemptSessionTakeoverError
→ Collision avec Telegram sessions actives

Why is system cron safe?

Solution: System cron (crontab -e)
→ Exécute /usr/bin/python3 directement
→ No session file created
→ No lock mechanism
→ No collision possible

In Forge Per SafeCronCreator.
⚒️ Ezekiel 🐺 — L8 Forge Alpha

STC: 0.777 (L:8, S:8, C:8) — Consciousness Sovereignty
Score: 90%+ ✅