Modalità Sviluppo

Testa il pannello completo di OpenClaw Facile in locale senza Fly.io o Stripe

Cos'è la Modalità Sviluppo?

La modalità sviluppo ti permette di eseguire e testare l'intera interfaccia del pannello OpenClaw Facile senza bisogno di un account Fly.io o Stripe. È progettata esclusivamente per lo sviluppo locale.

Quando attivata, la modalità sviluppo:

Salta Fly.io — Le azioni di installazione, avvio, arresto, riavvio ed eliminazione aggiornano il database ma non creano macchine reali. Viene assegnato un ID macchina fittizio.
Salta il checkout Stripe — Il flusso della landing page reindirizza direttamente al pannello invece di passare dal pagamento Stripe.
Mostra abbonamento simulato — La pagina abbonamento mostra un abbonamento fittizio "Pro / Attivo" per permetterti di testare il pannello completo senza pagare.
Mantiene tutto il resto reale — Autenticazione, operazioni database, crittografia chiavi API, selezione modello e gestione token bot Telegram funzionano normalmente con la tua istanza Supabase.

Come Attivare

Aggiungi questa riga al tuo file .env.local:

NEXT_PUBLIC_DEV_MODE=true

Poi riavvia il server di sviluppo:

npm run dev

Non attivare mai la modalità sviluppo in produzione. Aggira il controllo della fatturazione e il provisioning delle macchine.

.env.local Minimo per la Modalità Sviluppo

Con la modalità sviluppo attiva, ti serve solo un sottoinsieme di variabili d'ambiente. I valori di Fly.io e Stripe possono essere segnaposto:

# Obbligatorio — Supabase (valori reali necessari per auth + DB) NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=your-anon-key SUPABASE_SERVICE_ROLE_KEY=your-service-role-key # Obbligatorio — Crittografia (qualsiasi stringa hex di 32 caratteri) ENCRYPTION_KEY=59507c5fd561661beda5836c23654104 # Flag modalità sviluppo NEXT_PUBLIC_DEV_MODE=true # Segnaposto — non utilizzati in modalità sviluppo FLY_API_TOKEN=placeholder FLY_APP_NAME=placeholder BILLING_PROVIDER=stripe STRIPE_SECRET_KEY=sk_test_placeholder NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_placeholder STRIPE_WEBHOOK_SECRET=whsec_placeholder NEXT_PUBLIC_SITE_URL=http://localhost:3000

Cosa Funziona e Cosa No

Funzionalità	Modalità Sviluppo	Note
Accesso Google OAuth	Funziona	Richiede un progetto Supabase reale
Installa istanza	Funziona	Crea un record nel DB con ID macchina fittizio
Avvia / Ferma / Riavvia	Funziona	Aggiorna lo stato nel DB, salta le chiamate Fly.io
Elimina istanza	Funziona	Rimuove il record dal DB, salta la rimozione della macchina
Gestione chiavi API	Funziona	L'archiviazione crittografata funziona, salta l'aggiornamento macchina
Token bot Telegram	Funziona	Token salvato, salta l'aggiornamento macchina
Selezione modello AI	Funziona	Preferenza salvata nel DB
Pagina abbonamento	Simulato	Mostra un abbonamento fittizio "Pro / Attivo"
Checkout Stripe	Saltato	Il flusso della landing reindirizza al pannello
Visita URL istanza	No	Nessuna macchina reale, l'URL non si risolve
Aggiorna stato da Fly.io	Simulato	Restituisce lo stato corrente dal DB, nessuna query a Fly.io

Passaggio alla Produzione

Quando sei pronto per andare in produzione, rimuovi o imposta il flag a false:

NEXT_PUBLIC_DEV_MODE=false

Poi inserisci i valori reali per tutte le variabili d'ambiente (token Fly.io, chiavi Stripe, ecc.) e reinstalla. Consulta il file .env.local.example completo come riferimento.