docs/docs/it/reference/api-usage-costs.md

read_when	summary	title	x-i18n
Vuoi capire quali funzionalità possono chiamare API a pagamento Devi verificare chiavi, costi e visibilità dell’utilizzo Stai spiegando la reportistica dei costi in `/status` o `/usage`	Verifica cosa può comportare costi, quali chiavi vengono utilizzate e come visualizzare l’utilizzo	Utilizzo e costi delle API	generated_at model provider source_hash source_path workflow 2026-04-13T08:27:13Z gpt-5.4 openai f5077e74d38ef781ac7a72603e9f9e3829a628b95c5a9967915ab0f321565429 reference/api-usage-costs.md 15

Utilizzo e costi delle API

Questo documento elenca le funzionalità che possono invocare chiavi API e dove compaiono i relativi costi. Si concentra sulle funzionalità di OpenClaw che possono generare utilizzo del provider o chiamate API a pagamento.

Dove compaiono i costi (chat + CLI)

Snapshot dei costi per sessione

• /status mostra il modello della sessione corrente, l’utilizzo del contesto e i token dell’ultima risposta.
• Se il modello usa autenticazione con chiave API, /status mostra anche il costo stimato dell’ultima risposta.
• Se i metadati della sessione live sono scarsi, /status può recuperare i contatori di token/cache e l’etichetta del modello runtime attivo dalla voce di utilizzo più recente della trascrizione. I valori live esistenti diversi da zero hanno comunque la precedenza, e i totali della trascrizione dimensionati sul prompt possono prevalere quando i totali memorizzati mancano o sono inferiori.

Piè di pagina dei costi per messaggio

• /usage full aggiunge un piè di pagina di utilizzo a ogni risposta, incluso il costo stimato (solo con chiave API).
• /usage tokens mostra solo i token; i flussi OAuth/token in stile abbonamento e CLI nascondono il costo in dollari.
• Nota su Gemini CLI: quando la CLI restituisce output JSON, OpenClaw legge l’utilizzo da stats, normalizza stats.cached in cacheRead e ricava i token di input da stats.input_tokens - stats.cached quando necessario.

Nota su Anthropic: il personale Anthropic ci ha detto che l’utilizzo di Claude CLI in stile OpenClaw è di nuovo consentito, quindi OpenClaw considera il riutilizzo di Claude CLI e l’uso di claude -p come autorizzati per questa integrazione, a meno che Anthropic non pubblichi una nuova policy. Anthropic continua comunque a non esporre una stima in dollari per messaggio che OpenClaw possa mostrare in /usage full.

Finestre di utilizzo della CLI (quote provider)

• openclaw status --usage e openclaw channels list mostrano le finestre di utilizzo del provider (snapshot delle quote, non costi per messaggio).
• L’output leggibile è normalizzato in X% left per tutti i provider.
• Provider attuali con finestra di utilizzo: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi e z.ai.
• Nota su MiniMax: i suoi campi grezzi usage_percent / usagePercent indicano la quota rimanente, quindi OpenClaw li inverte prima della visualizzazione. I campi basati sul conteggio hanno comunque la precedenza quando presenti. Se il provider restituisce model_remains, OpenClaw preferisce la voce del modello di chat, ricava l’etichetta della finestra dai timestamp quando necessario e include il nome del modello nell’etichetta del piano.
• L’autenticazione di utilizzo per queste finestre di quota proviene da hook specifici del provider quando disponibili; in caso contrario, OpenClaw usa come fallback la corrispondenza delle credenziali OAuth/chiave API dai profili di autenticazione, dall’ambiente o dalla configurazione.

Consulta Uso dei token e costi per dettagli ed esempi.

Come vengono individuate le chiavi

OpenClaw può rilevare le credenziali da:

• Profili di autenticazione (per agente, memorizzati in auth-profiles.json).
• Variabili d’ambiente (ad es. OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY).
• Configurazione (models.providers.*.apiKey, plugins.entries.*.config.webSearch.apiKey, plugins.entries.firecrawl.config.webFetch.apiKey, memorySearch.*, talk.providers.*.apiKey).
• Skills (skills.entries.<name>.apiKey) che possono esportare chiavi nell’ambiente del processo della skill.

Funzionalità che possono consumare chiavi

1) Risposte del modello core (chat + strumenti)

Ogni risposta o chiamata di strumento usa il provider del modello corrente (OpenAI, Anthropic, ecc.). Questa è la fonte primaria di utilizzo e costo.

Questo include anche i provider ospitati in stile abbonamento che continuano a fatturare al di fuori dell’interfaccia locale di OpenClaw, come OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI / GLM Coding Plan e il percorso di login Claude di OpenClaw di Anthropic con Extra Usage abilitato.

Consulta Modelli per la configurazione dei prezzi e Uso dei token e costi per la visualizzazione.

2) Comprensione dei contenuti multimediali (audio/immagine/video)

I contenuti multimediali in ingresso possono essere riassunti/trascritti prima che venga eseguita la risposta. Questo usa API di modelli/provider.

• Audio: OpenAI / Groq / Deepgram / Google / Mistral.
• Immagine: OpenAI / OpenRouter / Anthropic / Google / MiniMax / Moonshot / Qwen / Z.AI.
• Video: Google / Qwen / Moonshot.

Consulta Comprensione dei contenuti multimediali.

3) Generazione di immagini e video

Le funzionalità di generazione condivise possono anch’esse consumare chiavi provider:

• Generazione di immagini: OpenAI / Google / fal / MiniMax
• Generazione di video: Qwen

La generazione di immagini può dedurre un provider predefinito supportato da autenticazione quando agents.defaults.imageGenerationModel non è impostato. La generazione di video attualmente richiede un valore esplicito per agents.defaults.videoGenerationModel, ad esempio qwen/wan2.6-t2v.

Consulta Generazione di immagini, Qwen Cloud e Modelli.

4) Embedding della memoria + ricerca semantica

La ricerca semantica nella memoria usa API di embedding quando è configurata per provider remoti:

• memorySearch.provider = "openai" → embedding OpenAI
• memorySearch.provider = "gemini" → embedding Gemini
• memorySearch.provider = "voyage" → embedding Voyage
• memorySearch.provider = "mistral" → embedding Mistral
• memorySearch.provider = "lmstudio" → embedding LM Studio (locale/self-hosted)
• memorySearch.provider = "ollama" → embedding Ollama (locale/self-hosted; in genere senza fatturazione API ospitata)
• Fallback opzionale a un provider remoto se gli embedding locali falliscono

Puoi mantenerlo locale con memorySearch.provider = "local" (nessun utilizzo API).

Consulta Memoria.

5) Strumento di ricerca web

web_search può comportare costi di utilizzo a seconda del provider:

• Brave Search API: BRAVE_API_KEY o plugins.entries.brave.config.webSearch.apiKey
• Exa: EXA_API_KEY o plugins.entries.exa.config.webSearch.apiKey
• Firecrawl: FIRECRAWL_API_KEY o plugins.entries.firecrawl.config.webSearch.apiKey
• Gemini (Google Search): GEMINI_API_KEY o plugins.entries.google.config.webSearch.apiKey
• Grok (xAI): XAI_API_KEY o plugins.entries.xai.config.webSearch.apiKey
• Kimi (Moonshot): KIMI_API_KEY, MOONSHOT_API_KEY o plugins.entries.moonshot.config.webSearch.apiKey
• MiniMax Search: MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, MINIMAX_API_KEY o plugins.entries.minimax.config.webSearch.apiKey
• Ollama Web Search: senza chiave per impostazione predefinita, ma richiede un host Ollama raggiungibile più ollama signin; può anche riutilizzare la normale autenticazione bearer del provider Ollama quando l’host la richiede
• Perplexity Search API: PERPLEXITY_API_KEY, OPENROUTER_API_KEY o plugins.entries.perplexity.config.webSearch.apiKey
• Tavily: TAVILY_API_KEY o plugins.entries.tavily.config.webSearch.apiKey
• DuckDuckGo: fallback senza chiave (nessuna fatturazione API, ma non ufficiale e basato su HTML)
• SearXNG: SEARXNG_BASE_URL o plugins.entries.searxng.config.webSearch.baseUrl (senza chiave/self-hosted; nessuna fatturazione API ospitata)

I percorsi provider legacy tools.web.search.* vengono ancora caricati tramite lo shim di compatibilità temporaneo, ma non sono più la superficie di configurazione consigliata.

Credito gratuito Brave Search: ogni piano Brave include 5 $/mese di credito gratuito rinnovabile. Il piano Search costa 5 $ ogni 1.000 richieste, quindi il credito copre 1.000 richieste/mese senza addebito. Imposta il tuo limite di utilizzo nella dashboard Brave per evitare addebiti imprevisti.

Consulta Strumenti web.

5) Strumento di recupero web (Firecrawl)

web_fetch può chiamare Firecrawl quando è presente una chiave API:

• FIRECRAWL_API_KEY o plugins.entries.firecrawl.config.webFetch.apiKey

Se Firecrawl non è configurato, lo strumento usa come fallback il recupero diretto + readability (nessuna API a pagamento).

Consulta Strumenti web.

6) Snapshot di utilizzo del provider (stato/salute)

Alcuni comandi di stato chiamano gli endpoint di utilizzo del provider per visualizzare finestre di quota o stato di salute dell’autenticazione. Si tratta in genere di chiamate a basso volume, ma colpiscono comunque le API del provider:

• openclaw status --usage
• openclaw models status --json

Consulta CLI dei modelli.

7) Riassunto di salvaguardia della Compaction

La salvaguardia della Compaction può riassumere la cronologia della sessione usando il modello corrente, che invoca API del provider quando viene eseguita.

Consulta Gestione della sessione + compaction.

8) Scansione / probe dei modelli

openclaw models scan può sondare i modelli OpenRouter e usa OPENROUTER_API_KEY quando il probing è abilitato.

Consulta CLI dei modelli.

9) Talk (voce)

La modalità Talk può invocare ElevenLabs quando configurata:

• ELEVENLABS_API_KEY o talk.providers.elevenlabs.apiKey

Consulta Modalità Talk.

10) Skills (API di terze parti)

Le Skills possono memorizzare apiKey in skills.entries.<name>.apiKey. Se una skill usa tale chiave per API esterne, può comportare costi in base al provider della skill.

Consulta Skills.