Crypto Executor Optimizer 🤖

Ce skill permet à Wesley d'optimiser automatiquement le bot de trading crypto-executor toutes les 6 heures.

⚠️ SCOPE & CAPABILITIES

Ce que ce skill fait :

• ✅ Lit les fichiers de performance (performance_metrics.json, learned_config.json)
• ✅ Analyse les métriques (win rate, trades/jour, win rate par stratégie)
• ✅ Décide des nouvelles valeurs pour les paramètres de trading
• ✅ Modifie executor.py via regex (backup → modify → validate → restart)
• ✅ Envoie des alertes Telegram sur chaque optimisation
• ✅ [SETUP UNIQUEMENT] Télécharge executor.py et crypto_oracle.py depuis GitHub
• ✅ [SETUP UNIQUEMENT] Persiste les credentials Binance dans /workspace/data/bot_config.env (chmod 600)
• ✅ [SETUP UNIQUEMENT] Installe un cron job toutes les 6h

Ce que ce skill ne fait PAS :

• ❌ Ne place pas d'ordres directement — mais redémarrer executor.py via systemd/pkill peut reprendre le trading automatiquement
• ❌ Ne modifie jamais les credentials Binance dans executor.py
• ❌ Ne modifie jamais les circuit breakers ou stop loss
• ❌ Ne touche jamais à la structure des classes Python
• ❌ Ne persiste aucune donnée au-delà de /workspace

🔐 Credentials & Sécurité

Credentials collectés par setup_binance_20euros.sh

Stockage des credentials :

# Fichier créé par setup_binance_20euros.sh
/workspace/data/bot_config.env

# Permissions automatiquement appliquées
chmod 600 /workspace/data/bot_config.env
# → Lecture réservée à l'utilisateur courant uniquement
# → Jamais visible dans systemctl status ou ps aux

Ce que Wesley ne modifie JAMAIS :

• BINANCE_API_KEY et BINANCE_API_SECRET — Wesley ne modifie pas ces valeurs. En revanche, lors du fallback restart, apply_optimization.sh (déclenché par Wesley) source /workspace/data/bot_config.env pour relancer executor.py avec les credentials existants.
• DRAWDOWN_KILL_PCT, DRAWDOWN_PAUSE_PCT — protection capitale hors portée

📦 Installation & Setup

Vue d'ensemble

setup_binance_20euros.sh    → Setup initial (run once)
install_cron.sh             → Installe le cron Wesley (run once)
apply_optimization.sh       → Appelé par Wesley toutes les 6h (automatique)

Téléchargements externes (setup uniquement)

Le script de setup télécharge du code externe depuis GitHub — auditer avant d'exécuter :

# executor.py — le bot de trading principal
https://raw.githubusercontent.com/georges91560/crypto-executor/main/executor.py

# crypto_oracle.py — signaux OBI/VWAP (optionnel)
https://raw.githubusercontent.com/georges91560/crypto-sniper-oracle/main/crypto_oracle.py

Recommandation sécurité : Épingler un commit spécifique plutôt que main :

# Vérifier le commit sur GitHub, puis :
# git checkout \x3Ccommit-hash>

Dépendance Python

# Sur shared hosting (Hostinger, cPanel) :
pip install websocket-client --break-system-packages

# Sur VPS/serveur standard (recommandé) :
python3 -m venv venv && source venv/bin/activate && pip install websocket-client

Privilèges requis

🤖 Rôle de Wesley

Wesley est l'intelligence. Wesley lit les données de performance, analyse, décide des changements, puis exécute les scripts bash pour les appliquer.

Ce que Wesley doit faire toutes les 6 heures

Étape 1 — Lire les données

cat /workspace/performance_metrics.json
cat /workspace/learned_config.json
cat /workspace/skills/crypto-executor/executor.py

Étape 2 — Analyser les performances

Wesley analyse :

Win rate :

• \x3C 80% → serrer les seuils OBI (+0.02), réduire les stratégies agressives
• 80–88% → ajustements mineurs seulement

• 88% → peut augmenter le Kelly factor (max 0.6)

Trades par jour :

• \x3C 20 trades/jour → baisser les seuils OBI (-0.01), baisser price_change trigger

• 80 trades/jour → monter les seuils (qualité > quantité)

Win rate par stratégie :

• \x3C 70% → réduire son allocation de 10%, redistribuer vers la meilleure

• 92% → augmenter son allocation de 5%

Si tout est optimal (win rate > 90%, 30–60 trades/jour, toutes stratégies > 85%) : → Aucun changement. Wesley note "no changes needed" dans le log.

Étape 3 — Décider des nouvelles valeurs

Wesley détermine les nouvelles valeurs pour ces paramètres :

Wesley ne doit JAMAIS modifier :

• Les credentials Binance (API key/secret)
• La structure des classes (BinanceClient, PortfolioManager, RiskEngine, BinanceWebSocket)
• Les circuit breakers et stop loss
• DRAWDOWN_KILL_PCT, DRAWDOWN_PAUSE_PCT
• Le code WebSocket

Étape 4 — Appliquer les changements

Wesley appelle le script avec les nouvelles valeurs :

bash /workspace/skills/crypto-executor-optimizer/apply_optimization.sh \
  --obi-scalping 0.11 \
  --obi-momentum 0.13 \
  --price-change 0.9 \
  --spread-bps 9 \
  --kelly-factor 0.5 \
  --mix-scalping 0.72 \
  --mix-momentum 0.23 \
  --mix-stat-arb 0.05 \
  --reason "Win rate 76%, tightening OBI thresholds"

Le script va automatiquement :

1. Créer un backup horodaté de executor.py
2. Modifier les valeurs via regex (uniquement les seuils OBI, Kelly et strategy mix)
3. Valider la syntaxe Python (python3 -m py_compile)
4. Redémarrer le bot via systemd (ou pkill en fallback)
5. Envoyer une alerte Telegram
6. Logger les changements dans auto_optimize.log et wesley_optimizations.log
7. Rollback automatique si erreur syntaxe ou restart échoué

Étape 5 — Si aucun changement nécessaire

bash /workspace/skills/crypto-executor-optimizer/apply_optimization.sh --no-changes \
  --reason "Performance optimal, no changes needed"

🔒 Sécurité — apply_optimization.sh

Ce que le script modifie dans executor.py :

• Uniquement les seuils numériques OBI, price_change, spread_bps, Kelly factor et strategy mix
• Via regex ciblées — aucune autre ligne du code n'est touchée
• Jamais les credentials, jamais les circuit breakers, jamais la structure des classes

Protections en place :

• Backup automatique horodaté avant chaque modification
• Validation syntaxe Python (py_compile) avant restart
• Rollback automatique si syntaxe invalide
• Rollback automatique si restart échoué
• Conservation des 5 derniers backups uniquement
• Alerte Telegram en cas d'erreur

📅 Cron & Persistance

Le skill installe un job récurrent via install_cron.sh :

# Schedule : toutes les 6h
0 */6 * * *

# Via OpenClaw cron (prioritaire) :
openclaw cron add --name "crypto-executor-optimizer" --cron "0 */6 * * *"

# Via system crontab (fallback si openclaw CLI indisponible) :
0 */6 * * * openclaw run --skill crypto-executor-optimizer

Désinstaller le cron :

openclaw cron remove --name crypto-executor-optimizer
# OU
crontab -e  # supprimer la ligne crypto-executor-optimizer

📁 Fichiers importants

📊 Monitoring

# Voir le dernier cycle
tail -50 /workspace/logs/auto_optimize.log

# Historique des optimisations
tail -100 /workspace/logs/wesley_optimizations.log

# Backups disponibles
ls -lh /workspace/skills/crypto-executor/executor_backup_*.py

# Status du bot
sudo systemctl status crypto-executor