openclaw promos

Scopri e richiedi le offerte promozionali sui modelli pubblicate su ClawHub. La richiesta di una promozione configura il provider (autenticazione e Plugin, quando necessario) e registra i modelli della promozione, senza eseguire nuovamente la procedura di configurazione iniziale e senza modificare il modello predefinito, a meno che tu non lo richieda.

Argomenti correlati:

• Modello predefinito e modelli di riserva: Modelli
• Configurazione dell'autenticazione del provider: Guida introduttiva

Comandi

openclaw promos listopenclaw promos claim <slug>openclaw promos claim <slug> --api-key <key> --set-default

openclaw promos list

Elenca le promozioni attualmente attive, con i relativi modelli, il modello predefinito suggerito, il tempo rimanente e il comando esatto per richiederle. --json stampa il payload non elaborato.

openclaw promos claim <slug>

Richiede una promozione attiva:

1. Recupera la promozione da ClawHub e verifica che rientri nel periodo di validità.
2. Convalida il provider della promozione, il metodo di autenticazione e i pacchetti Plugin dichiarati rispetto alla versione di OpenClaw installata. Gli ID sconosciuti o le discrepanze tra i pacchetti vengono rifiutati: una promozione non può mai indurre la CLI a eseguire operazioni che non sa già come effettuare.
3. Riutilizza le credenziali esistenti del provider, se disponibili. In caso contrario, avvia il normale flusso di autenticazione del provider, mostrando prima l'URL di registrazione della promozione per ottenere una chiave gratuita. --api-key <key> completa l'autenticazione tramite chiave API senza richieste interattive, in modo coerente con le opzioni non interattive di openclaw onboard; per evitare di inserire la chiave nella riga di comando, esporta invece la variabile di ambiente del provider, ad esempio OPENROUTER_API_KEY: le credenziali già presenti nell'ambiente vengono rilevate automaticamente e non è necessaria alcuna opzione.
4. Registra i modelli della promozione con i relativi alias. Gli alias esistenti non vengono mai sovrascritti.
5. Propone di impostare come predefinito il modello suggerito dalla promozione: --set-default salta la domanda; in caso contrario, le impostazioni predefinite non vengono modificate.

Al termine del periodo di validità della promozione, il provider interrompe l'erogazione dei modelli gratuiti; la configurazione e le credenziali rimangono invariate. Puoi cambiare nuovamente modello in qualsiasi momento con openclaw models set <model>.

Individuazione passiva in models list

openclaw models list mostra anche le promozioni senza che sia necessario interrogare direttamente ClawHub:

• Le offerte attive i cui modelli non sono stati configurati vengono visualizzate in un gruppo "Disponibili tramite promozione" sotto la tabella, ciascuna con il relativo comando di richiesta.
• I modelli registrati tramite promos claim presentano un'etichetta promo, che diventa promo ended al termine del periodo di validità dell'offerta.
• La prima volta che viene rilevata una nuova offerta, un avviso visualizzato una sola volta rimanda a openclaw promos list. Le offerte già elencate o richieste non vengono più annunciate.

Questa funzionalità legge una copia memorizzata nella cache locale del feed delle promozioni ospitato da ClawHub, normalmente aggiornata una volta al giorno tramite una richiesta condizionale oppure prima, alla scadenza dell'istantanea memorizzata nella cache; gli errori di aggiornamento vengono ignorati senza avvisi. L'aggiornamento di una copia non più recente attende al massimo 2,5 secondi e non interrompe mai la visualizzazione dell'elenco. L'output di --json e --plain rimane adatto all'elaborazione automatica: non include sezioni o avvisi relativi alle promozioni. La richiesta di una promozione viene sempre riconvalidata tramite l'API ClawHub in tempo reale, pertanto un'offerta ritirata in anticipo viene rifiutata anche se è ancora visibile in una copia memorizzata nella cache.