Article 4

Cet article couvre la mise en œuvre technique complète de SafeClaw — de l'interface Telegram jusqu'à la couche API Binance.

━━━ VUE D'ENSEMBLE DU SYSTÈME ━━━

SafeClaw est un système multi-niveaux :

NIVEAU 1 — Interface Utilisateur
API Bot Telegram (mode de polling long)
Aucun webhook requis. Fonctionne derrière NAT.
Se reconnecte automatiquement en cas d'interruption de réseau.

NIVEAU 2 — Passerelle IA
OpenClaw 2026.3.13
Fonctionne sur AWS EC2 t3.small (Ubuntu 24.04 LTS)
Service systemd — se lance automatiquement au démarrage, redémarre automatiquement en cas de crash
Port 18789 (boucle locale uniquement, pas exposé publiquement)

NIVEAU 3 — Couche du modèle IA
Principal : claude-haiku-4.5 via openrouter/anthropic/claude-haiku-4.5
Sauvegarde 1 : claude-sonnet-4-5 (précision plus élevée, coût plus élevé)
Sauvegarde 2 : meta-llama/llama-3.3-70b-instruct:free (sauvegarde de niveau gratuit)
Auto-basculer sur les limites de taux ou les erreurs

NIVEAU 4 — Couche des compétences (10 compétences)
Chaque compétence est un fichier SKILL.md en markdown avec des instructions en langage naturel.
Pas de code compilé. Pas de pipeline de déploiement.
Ajouter ou mettre à jour une compétence = éditer un fichier + redémarrer la passerelle.

NIVEAU 5 — Couche d'intégration API
6 environnements Binance + 3 sources de données externes

━━━ LA COUCHE DES COMPÉTENCES EN DÉTAIL ━━━

Le système de compétences d'OpenClaw fonctionne en injectant le contenu SKILL.md dans le contexte de l'agent lorsqu'il est déclenché par des mots-clés ou des commandes pertinents.

10 compétences de SafeClaw :

1. api-router
Couche de routage interne. Lit le type de compte de l'utilisateur à partir de la session et renvoie l'URL de base et les identifiants corrects. Appelé par toutes les compétences nécessitant un accès à l'API Binance.

2. p2p-safefinder
Appelle l'API de recherche P2P de Binance avec des en-têtes de requête compressés. Applique un modèle de scoring. Renvoie une liste de marchands classée.

3. guardianclaw
Récupère les données de ticker en direct sur 24 heures, la profondeur du carnet de commandes, les transactions récentes. Exécute un questionnaire psychologique. Calcule un score de sécurité composite.

4. smartdca
Récupère l'indice de peur et de cupidité. Calcule un multiplicateur adaptatif. Appelle api-router pour le bon point de terminaison. Exécute un ordre de marché. Enregistre dans l'historique de la session.

5. briefing
Récupère par lots 5 tickers d'actifs majeurs. Récupère les principaux mouvements. Récupère le taux P2P local. Récupère la peur et la cupidité. Formate un résumé de marché structuré.

6. safeclaw-academy
Route vers une démo ou un testnet en fonction du type de compte utilisateur. Exécute des ordres réels sur l'API de démo Binance. Calcule les prix de liquidation. Évalue les décisions de trading. Lien vers les ressources de l'Académie Binance.

7. yield-monitor
Appelle les points de terminaison de l'API Binance Earn. Compare les taux actuels aux taux disponibles. Calcule les opportunités d'optimisation du rendement.

8. square-content-engine
Récupère plusieurs flux RSS et données de marché simultanément. Génère 3 variations de brouillon avec différents profils d'optimisation. Publie via l'OpenAPI de Binance Square.

9. user-onboarding
Assistant en 5 étapes. Valide les clés API par rapport aux bons points de terminaison. Stocke le type de compte et les préférences dans la session. Gère les comptes réels, de démo et de testnet.

10. profile
Lit les paramètres de la session. Récupère le solde en direct depuis le bon point de terminaison Binance. Affiche une vue unifiée du profil.

━━━ UTILISATION DE L'API BINANCE ━━━

SafeClaw utilise plus d'API Binance que tout autre projet OpenClaw dont nous sommes conscients :

APIs publiques (pas d'authentification) :
• GET /api/v3/ticker/24hr — données de prix et de volume
• GET /api/v3/ticker/price — prix actuel
• GET /api/v3/depth — carnet de commandes
• GET /api/v3/trades — transactions récentes
• POST p2p.binance.com/.../adv/search — liste des marchands P2P

APIs authentifiées (clé de l'utilisateur) :
• GET /api/v3/account — validation du solde et des autorisations
• POST /api/v3/order — exécution d'ordre de marché au comptant
• POST /fapi/v1/leverage — réglage de l'effet de levier des contrats à terme
• POST /fapi/v1/order — ordre de marché des contrats à terme
• GET /fapi/v2/account — solde des contrats à terme
• GET /fapi/v2/positionRisk — positions ouvertes des contrats à terme
• GET /sapi/v1/lending/union/account — aperçu de l'Earn
• GET /sapi/v1/lending/daily/product/list — taux d'Earn
• GET /sapi/v1/staking/position — positions de staking

APIs de démo Binance :
• demo-api.binance.com — identique à l'API au comptant en direct
• demo-fapi.binance.com — identique à l'API des contrats à terme en direct

API Binance Square :
• POST /bapi/composite/v1/public/pgc/openApi/content/add

Signature de la demande : HMAC SHA256 avec horodatage + chaîne de paramètres.
Toutes les demandes signées utilisent la propre clé API de l'utilisateur — jamais une clé de serveur partagée.

━━━ INFRASTRUCTURE ━━━

Serveur : AWS EC2 t3.small
• vCPUs : 2
• RAM : 2 Go + 2 Go swap
• Stockage : 30 Go gp3 EBS
• OS : Ubuntu 24.04 LTS
• Coût : ~15 $/mois (niveau gratuit éligible pendant 12 mois)

Runtime : Node.js 22.22.1 (package système, pas nvm)
Package : OpenClaw installé via npm global
Service : service utilisateur systemd avec maintien activé
Surveillance : statut de la passerelle openclaw + journaux openclaw

GitHub : https://github.com/bnbnepalbinanceangel/SafeClaw
Modèle de configuration : config.template.json (pas de secrets)
Compétences : répertoire skills/ (10 fichiers SKILL.md)
Espace de travail : workspace/ (SOUL.md, AGENTS.md, IDENTITY.md)

━━━ ARCHITECTURE DE DÉPLOIEMENT ━━━

Développement local :
WSL2 Ubuntu sur Windows 11
Installation native d'OpenClaw (pas Docker)
Bot de test local avec un jeton séparé
Testnet Binance pour des tests de trading sûrs

Production :
AWS EC2 t3.small toujours actif
Jeton de bot de production
API de démo Binance pour la fonctionnalité Académie
API Binance réelle pour utilisateurs en direct

Pipeline de déploiement :
git push → SSH vers le serveur → git pull → cp skills → redémarrer la passerelle
(Script de mise à jour automatisé : ~/update-safeclaw.sh)

━━━ EFFICACITÉ DES COÛTS ━━━

Inférence IA : Claude Haiku 4.5 ≈ 0,001 $ par message
Serveur : ~15 $/mois AWS EC2 t3.small
OpenRouter : paiement à l'utilisation, pas de minimum
Total pour 1 000 utilisateurs/jour : ~16 $/mois

Cela fait de SafeClaw l'un des bots IA de production les plus rentables sur l'infrastructure de Binance.

━━━ CHEMIN DE SCALABILITÉ ━━━

L'architecture actuelle prend en charge des centaines d'utilisateurs simultanés sur t3.small.

Chemin de mise à l'échelle horizontale :
→ t3.small → t3.medium → t3.large (vertical, simple)
→ Plusieurs instances OpenClaw derrière un équilibreur de charge (horizontal)
→ Stockage de session Redis pour un état partagé (multi-instance)
→ Nœuds de travail séparés pour des sous-agents lourds (SmartDCA, Académie)

La création native d'agents multiples d'OpenClaw (sessions_spawn) est déjà configurée pour la concurrence des sous-agents jusqu'à 8 agents parallèles par orchestrateur principal.

Liens rapides :

Article 1 Article 2 Article 3 Article 5 Article 6 Article 7 Article 8

Source : https://github.com/bnbnepalbinanceangel/SafeClaw

#AIBinance #SafeClaw #TechStack #OpenClaw #Binance