--- read_when: - Vuoi capire quali funzionalità possono chiamare API a pagamento - Devi controllare chiavi, costi e visibilità dell'utilizzo - Stai spiegando la rendicontazione dei costi di /status o /usage summary: Verificare cosa può generare costi, quali chiavi vengono usate e come visualizzare l'utilizzo title: Utilizzo dell'API e costi x-i18n: generated_at: "2026-05-06T09:07:21Z" model: gpt-5.5 provider: openai source_hash: c8e6f9f8248ddb4241d00191aa231f1d72a2128a7995b4ed0ec0e18a7ed6dd69 source_path: reference/api-usage-costs.md workflow: 16 --- Questo documento elenca le **funzionalità che possono invocare chiavi API** e dove vengono visualizzati i relativi costi. Si concentra sulle funzionalità di OpenClaw che possono generare utilizzo dei provider o chiamate API a pagamento. ## Dove vengono visualizzati i costi (chat + CLI) **Snapshot del costo 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 dall'ultima voce di utilizzo della trascrizione. I valori live non nulli esistenti hanno comunque la precedenza, e i totali della trascrizione dimensionati sul prompt possono prevalere quando i totali memorizzati mancano o sono inferiori. **Footer del costo per messaggio** - `/usage full` aggiunge un footer di utilizzo a ogni risposta, incluso il **costo stimato** (solo 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 deriva i token di input da `stats.input_tokens - stats.cached` quando necessario. Nota su Anthropic: lo staff di Anthropic ci ha comunicato che l'utilizzo di Claude CLI in stile OpenClaw è di nuovo consentito, quindi OpenClaw considera il riuso di Claude CLI e l'utilizzo di `claude -p` autorizzati per questa integrazione, a meno che Anthropic non pubblichi una nuova policy. Anthropic continua a non esporre una stima in dollari per messaggio che OpenClaw possa mostrare in `/usage full`. **Finestre di utilizzo della CLI (quote dei provider)** - `openclaw status --usage` e `openclaw channels list` mostrano le **finestre di utilizzo** dei provider (snapshot delle quote, non costi per messaggio). - L'output leggibile dalle persone viene normalizzato in `X% left` tra i provider. - Provider attuali per le finestre di utilizzo: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi e z.ai. - Nota su MiniMax: i suoi campi raw `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 chat, deriva l'etichetta della finestra dai timestamp quando necessario e include il nome del modello nell'etichetta del piano. - L'autenticazione per l'utilizzo di queste finestre di quota proviene da hook specifici del provider quando disponibili; altrimenti OpenClaw ripiega su credenziali OAuth/chiave API corrispondenti da profili di autenticazione, env o configurazione. Consulta [Utilizzo dei token e costi](/it/reference/token-use) per dettagli ed esempi. ## Come vengono scoperte le chiavi OpenClaw può rilevare 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..apiKey`) che possono esportare chiavi nell'env del processo della skill. ## Funzionalità che possono consumare chiavi ### 1) Risposte del modello core (chat + strumenti) Ogni risposta o chiamata a uno strumento usa il **provider del modello corrente** (OpenAI, Anthropic, ecc.). Questa è la fonte principale di utilizzo e costi. Questo include anche provider ospitati in stile abbonamento che fatturano comunque al di fuori dell'interfaccia utente locale di OpenClaw, come **OpenAI Codex**, **Alibaba Cloud Model Studio Coding Plan**, **MiniMax Coding Plan**, **Z.AI / GLM Coding Plan** e il percorso di accesso OpenClaw Claude di Anthropic con **Utilizzo extra** abilitato. Consulta [Modelli](/it/providers/models) per la configurazione dei prezzi e [Utilizzo dei token e costi](/it/reference/token-use) per la visualizzazione. ### 2) Comprensione dei media (audio/immagine/video) I media in ingresso possono essere riassunti/trascritti prima che venga eseguita la risposta. Questo usa API di modelli/provider. - Audio: OpenAI / Groq / Deepgram / DeepInfra / Google / Mistral. - Immagine: OpenAI / OpenRouter / Anthropic / DeepInfra / Google / MiniMax / Moonshot / Qwen / Z.AI. - Video: Google / Qwen / Moonshot. Consulta [Comprensione dei media](/it/nodes/media-understanding). ### 3) Generazione di immagini e video Anche le capacità di generazione condivise possono consumare chiavi dei provider: - Generazione di immagini: OpenAI / Google / DeepInfra / fal / MiniMax - Generazione di video: DeepInfra / Qwen La generazione di immagini può inferire un default del provider basato sull'autenticazione quando `agents.defaults.imageGenerationModel` non è impostato. La generazione di video attualmente richiede un valore esplicito di `agents.defaults.videoGenerationModel`, ad esempio `qwen/wan2.6-t2v`. Consulta [Generazione di immagini](/it/tools/image-generation), [Qwen Cloud](/it/providers/qwen) e [Modelli](/it/concepts/models). ### 4) Embedding di 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 = "deepinfra"` → embedding DeepInfra - `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 non riescono Puoi mantenerla locale con `memorySearch.provider = "local"` (nessun utilizzo API). Consulta [Memoria](/it/concepts/memory). ### 5) Strumento di ricerca web `web_search` può comportare addebiti 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 un host Ollama locale raggiungibile e con accesso effettuato; la ricerca diretta su `https://ollama.com` usa `OLLAMA_API_KEY`, e gli host protetti da autenticazione possono riutilizzare la normale autenticazione bearer del provider Ollama - **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 temporaneo di compatibilità, 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 per 1.000 richieste, quindi il credito copre 1.000 richieste/mese senza addebiti. Imposta il limite di utilizzo nel dashboard Brave per evitare addebiti imprevisti. Consulta [Strumenti web](/it/tools/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 ripiega sul recupero diretto più il Plugin `web-readability` incluso (nessuna API a pagamento). Disabilita `plugins.entries.web-readability.enabled` per saltare l'estrazione locale Readability. Consulta [Strumenti web](/it/tools/web). ### 6) Snapshot di utilizzo del provider (stato/salute) Alcuni comandi di stato chiamano **endpoint di utilizzo del provider** per visualizzare finestre di quota o salute dell'autenticazione. Di solito sono chiamate a basso volume, ma raggiungono comunque le API dei provider: - `openclaw status --usage` - `openclaw models status --json` Consulta [CLI dei modelli](/it/cli/models). ### 7) Riassunto di salvaguardia della Compaction La salvaguardia della Compaction può riassumere la cronologia della sessione usando il **modello corrente**, il che invoca API dei provider quando viene eseguita. Consulta [Gestione della sessione + Compaction](/it/reference/session-management-compaction). ### 8) Scansione / probe dei modelli `openclaw models scan` può sondare i modelli OpenRouter e usa `OPENROUTER_API_KEY` quando il sondaggio è abilitato. Consulta [CLI dei modelli](/it/cli/models). ### 9) Parlato (voce) La modalità parlato può invocare **ElevenLabs** quando configurata: - `ELEVENLABS_API_KEY` o `talk.providers.elevenlabs.apiKey` Consulta [Modalità parlato](/it/nodes/talk). ### 10) Skills (API di terze parti) Le Skills possono memorizzare `apiKey` in `skills.entries..apiKey`. Se una skill usa quella chiave per API esterne, può generare costi secondo il provider della skill. Consulta [Skills](/it/tools/skills). ## Correlati - [Utilizzo dei token e costi](/it/reference/token-use) - [Caching dei prompt](/it/reference/prompt-caching) - [Monitoraggio dell'utilizzo](/it/concepts/usage-tracking)