Articolo 4

Questo articolo tratta l'implementazione tecnica completa di SafeClaw — dall'interfaccia Telegram fino al livello API di Binance.



━━━ PANORAMICA DEL SISTEMA ━━━

SafeClaw è un sistema multi-tier:

TIER 1 — Interfaccia Utente
Telegram Bot API (modalità di polling prolungato)
Nessun webhook richiesto. Funziona dietro NAT.
Si riconnette automaticamente in caso di interruzione della rete.

TIER 2 — Gateway AI
OpenClaw 2026.3.13
In esecuzione su AWS EC2 t3.small (Ubuntu 24.04 LTS)
Servizio systemd — avvio automatico all'accensione, riavvio automatico in caso di crash
Porta 18789 (solo loopback, non esposto pubblicamente)

TIER 3 — Livello Modello AI
Primario: claude-haiku-4.5 tramite openrouter/anthropic/claude-haiku-4.5
Fallback 1: claude-sonnet-4-5 (maggiore precisione, costo maggiore)
Fallback 2: meta-llama/llama-3.3-70b-instruct:free (backup piano gratuito)
Auto-ripristino su limiti di velocità o errori

TIER 4 — Livello Competenze (10 competenze)
Ogni competenza è un file SKILL.md in markdown con istruzioni in linguaggio naturale.
Nessun codice compilato. Nessuna pipeline di distribuzione.
Aggiungi o aggiorna una competenza = modifica un file + riavvia gateway.

TIER 5 — Livello Integrazione API
6 ambienti Binance + 3 fonti di dati esterne



━━━ IL LIVELLO DELLE COMPETENZE IN DETTAGLIO ━━━

Il sistema di competenze di OpenClaw funziona iniettando il contenuto di SKILL.md nel contesto dell'agente quando attivato da parole chiave o comandi rilevanti.

Le 10 competenze di SafeClaw:

1. api-router
Livello di routing interno. Legge il tipo di account dell'utente dalla sessione e restituisce l'URL di base corretto e le credenziali. Chiamato da tutte le competenze che necessitano di accesso all'API Binance.

2. p2p-safefinder
Chiama l'API di ricerca P2P di Binance con intestazioni di richiesta compresse. Applica modello di punteggio. Restituisce un elenco di commercianti classificati.

3. guardianclaw
Recupera i dati del ticker live delle 24 ore, la profondità del libro ordini, le transazioni recenti. Esegue questionario psicologico. Calcola punteggio di sicurezza composito.

4. smartdca
Recupera l'Indice di Paura & Avidità. Calcola moltiplicatore adattivo. Chiama api-router per il corretto endpoint. Esegue ordine di mercato. Registra nella cronologia della sessione.

5. briefing
Recupera in batch 5 ticker di asset principali. Recupera i top movers. Recupera il tasso P2P locale. Recupera Paura & Avidità. Formatta un riepilogo di mercato strutturato.

6. safeclaw-academy
Reindirizza a demo o testnet in base al tipo di account utente. Esegue ordini reali sull'API Demo di Binance. Calcola i prezzi di liquidazione. Valuta le decisioni di trading. Collega alle risorse di Binance Academy.

7. yield-monitor
Chiama gli endpoint API di Binance Earn. Confronta i tassi attuali con i tassi disponibili. Calcola opportunità di ottimizzazione del rendimento.

8. square-content-engine
Recupera più feed RSS e dati di mercato simultaneamente. Genera 3 variazioni di bozza con diversi profili di ottimizzazione. Pubblica tramite Binance Square OpenAPI.

9. user-onboarding
Procedura guidata in 5 fasi. Valida le chiavi API contro gli endpoint corretti. Memorizza il tipo di account e le preferenze nella sessione. Gestisce account reali, demo e testnet.

10. profile
Legge le impostazioni dalla sessione. Recupera il saldo live dall'endpoint Binance corretto. Mostra una vista unificata del profilo.



━━━ UTILIZZO DELL'API BINANCE ━━━

SafeClaw utilizza più API Binance di qualsiasi altro progetto OpenClaw di cui siamo a conoscenza:

API Pubbliche (senza autenticazione):
• GET /api/v3/ticker/24hr — dati di prezzo e volume
• GET /api/v3/ticker/price — prezzo attuale
• GET /api/v3/depth — libro ordini
• GET /api/v3/trades — transazioni recenti
• POST p2p.binance.com/.../adv/search — elenco commercianti P2P

API Autenticate (chiave dell'utente):
• GET /api/v3/account — validazione saldo e permessi
• POST /api/v3/order — esecuzione ordine di mercato spot
• POST /fapi/v1/leverage — impostazione leva futures
• POST /fapi/v1/order — ordine di mercato futures
• GET /fapi/v2/account — saldo futures
• GET /fapi/v2/positionRisk — posizioni futures aperte
• GET /sapi/v1/lending/union/account — panoramica di Earn
• GET /sapi/v1/lending/daily/product/list — tassi di Earn
• GET /sapi/v1/staking/position — posizioni di staking

API Demo di Binance:
• demo-api.binance.com — identico all'API spot live
• demo-fapi.binance.com — identico all'API futures live

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

Firma della richiesta: HMAC SHA256 con timestamp + stringa dei parametri.
Tutte le richieste firmate utilizzano la chiave API dell'utente — mai una chiave del server condivisa.



━━━ INFRASTRUTTURA ━━━

Server: AWS EC2 t3.small
• vCPUs: 2
• RAM: 2GB + 2GB swap
• Storage: 30GB gp3 EBS
• OS: Ubuntu 24.04 LTS
• Costo: ~$15/mese (piano gratuito idoneo per 12 mesi)

Runtime: Node.js 22.22.1 (pacchetto di sistema, non nvm)
Pacchetto: OpenClaw installato tramite npm globale
Servizio: servizio utente systemd con lingering abilitato
Monitoraggio: stato del gateway openclaw + log openclaw

GitHub: https://github.com/bnbnepalbinanceangel/SafeClaw
Modello di configurazione: config.template.json (senza segreti)
Competenze: directory skills/ (10 file SKILL.md)
Workspace: workspace/ (SOUL.md, AGENTS.md, IDENTITY.md)



━━━ ARCHITETTURA DI DISTRIBUZIONE ━━━

Sviluppo Locale:
WSL2 Ubuntu su Windows 11
Installazione nativa OpenClaw (non Docker)
Bot di test locale con token separato
Binance Testnet per test di trading sicuri

Produzione:
AWS EC2 t3.small sempre attivo
Token bot di produzione
API Demo di Binance per la funzionalità Academy
API Binance reale per utenti live

Pipeline di distribuzione:
git push → SSH al server → git pull → cp skills → riavvia gateway
(Script di aggiornamento automatizzato: ~/update-safeclaw.sh)



━━━ EFFICIENZA DEI COSTI ━━━

Inferenza AI: Claude Haiku 4.5 ≈ $0.001 per messaggio
Server: ~$15/mese AWS EC2 t3.small
OpenRouter: pagamento per utilizzo, senza minimo
Totale per 1.000 utenti/giorno: ~$16/mese

Questo rende SafeClaw uno dei bot AI di produzione più efficienti in termini di costi sull'infrastruttura di Binance.



━━━ PERCORSO DI SCALABILITÀ ━━━

L'architettura attuale supporta centinaia di utenti concorrenti su t3.small.

Percorso di scalabilità orizzontale:
→ t3.small → t3.medium → t3.large (verticale, semplice)
→ Molteplici istanze OpenClaw dietro un bilanciatore di carico (orizzontale)
→ Redis session store per stato condiviso (multi-istanza)
→ Nodi di lavoro separati per sottogenerali pesanti (SmartDCA, Academy)

Il spawning nativo multi-agente di OpenClaw (sessions_spawn) è già configurato per la concorrenza dei sottogenerali fino a 8 agenti paralleli per orchestratore principale.

Link Veloci:

Articolo 1 Articolo 2 Articolo 3 Articolo 5 Articolo 6 Articolo 7 Articolo 8

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

#AIBinance #SafeClaw #TechStack #OpenClaw #Binance