---
read_when:
    - 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`
summary: Verifica cosa può comportare costi, quali chiavi vengono utilizzate e come visualizzare l’utilizzo
title: Utilizzo e costi delle API
x-i18n:
    generated_at: "2026-04-13T08:27:13Z"
    model: gpt-5.4
    provider: openai
    source_hash: f5077e74d38ef781ac7a72603e9f9e3829a628b95c5a9967915ab0f321565429
    source_path: reference/api-usage-costs.md
    workflow: 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](/it/reference/token-use) 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](/it/providers/models) per la configurazione dei prezzi e [Uso dei token e costi](/it/reference/token-use) 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](/it/nodes/media-understanding).

### 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](/it/tools/image-generation), [Qwen Cloud](/it/providers/qwen)
e [Modelli](/it/concepts/models).

### 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](/it/concepts/memory).

### 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](/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 usa come fallback il recupero diretto + readability (nessuna API a pagamento).

Consulta [Strumenti web](/it/tools/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](/cli/models).

### 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](/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 probing è abilitato.

Consulta [CLI dei modelli](/cli/models).

### 9) Talk (voce)

La modalità Talk può invocare **ElevenLabs** quando configurata:

- `ELEVENLABS_API_KEY` o `talk.providers.elevenlabs.apiKey`

Consulta [Modalità Talk](/it/nodes/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](/it/tools/skills).
