La migliore API per OpenClaw: scegli provider e modello in base all'attività

Per scegliere la migliore API per OpenClaw, inizia da un provider di modelli documentato. Scegli OpenRouter per la varietà di modelli, Anthropic diretto per una configurazione Claude mirata e confronta Kunavo quando la tariffa del modello è il principale criterio di acquisto. Per la configurazione sostenibile più economica, separa i controlli di routine dal lavoro difficile invece di inviare ogni attività a un unico modello costoso.

Questa guida confronta l'API LLM che produce le risposte e le chiamate agli strumenti dell'assistente. I servizi di ricerca, navigazione e immagini sono acquisti separati. Per l'hosting e il costo operativo completo, consulta i prezzi di OpenClaw.

Scegli il provider in base a ciò che stai acquistando

OpenClaw pubblica una directory dei provider, una guida alla configurazione di OpenRouter e un riferimento separato per i provider personalizzati. Un gateway elencato in una tabella dei prezzi non è automaticamente un'integrazione OpenClaw integrata.

Usa modelli diversi per lavori diversi

Per brevi riepiloghi, classificazione e controlli heartbeat delimitati, inizia con Claude Haiku 4.5. Per programmazione ordinaria e lavoro con strumenti, seleziona Claude Sonnet 5. Per modifiche complesse ai repository e ragionamento prolungato, seleziona Claude Opus 5. Questi punti di partenza seguono le indicazioni di Anthropic sulla selezione dei modelli; non sono risultati di benchmark di OpenClaw.

Rendi esplicita la regola di escalation. Un controllo di routine può riportare uno stato noto o passare una condizione non familiare al modello più potente. Non dovrebbe trasformarsi silenziosamente in un'attività di debugging estesa. Se il controllo confronta solo un valore con una soglia, esegui direttamente il confronto e riserva il modello all'interpretazione delle eccezioni.

Il livello di capacità e il prezzo del provider sono decisioni separate. Confronta la riga effettiva del modello che vuoi; le tariffe di un gateway non devono seguire lo stesso ordine dei prezzi di listino del vendor.

Un confronto concreto dei prezzi

Confronta lo stesso modello tra provider. La tabella mostra USD per milione di token standard di input e output senza cache: i prezzi dell'API diretta di Anthropic verificati il 17 settembre 2026, accanto alle tariffe attuali del catalogo Kunavo. I costi della cache, degli strumenti a pagamento e le imposte sono separati.

Supponiamo che il tuo mese includa 10 milioni di token di input senza cache e 1 milione di token di output. Inserirli tutti su Claude Opus 5 costa $52,50 a queste tariffe. Allocare 9 milioni di token di input e 900.000 di output a Claude Haiku 4.5, con il resto su Claude Opus 5, costa $14,70.

Questo è un calcolo per una suddivisione di carico di lavoro ipotizzata, non un risparmio garantito. Esclude i costi della cache, gli strumenti esterni e l'infrastruttura, e presuppone che il modello più piccolo possa completare il lavoro assegnato senza tentativi aggiuntivi. Quest'ultima condizione determina se la tariffa inferiore produce una fattura più bassa.

Pianifica il primo pagamento e il contesto ricorrente

Kunavo inizia con una ricarica prepagata di 10 $, senza abbonamento obbligatorio e con un saldo che non scade. Un'attività piccola consuma parte di quel saldo; il suo costo in token non è il denaro necessario per aprire un account finanziato. La guida alla fatturazione spiega inoltre perché una stima del catalogo non è un limite massimo di prezzo: l'addebito finale può essere più alto quando la fatturazione basata sui costi upstream supera tale stima.

I termini dei crediti di OpenRouter fissano un acquisto minimo di 5 $. La sua commissione standard con carta per il pagamento a consumo è del 5,5%, con un minimo di 0,80 $ per ricarica. Pertanto 5 $ di crediti costano 5,80 $ prima delle imposte, mentre 100 $ costano 105,50 $. La commissione viene pagata quando ricarichi l'account, non viene aggiunta nuovamente a ogni chiamata API. Confronta il credito ricaricato che consumerai effettivamente.

Per un assistente che invia ripetutamente le stesse istruzioni, confronta i riscontri positivi nella cache riportati prima di scegliere in base al prezzo degli input nuovi. L'API diretta di Sonnet 5 costa 0,20 $ per milione di token letti dalla cache, 2,50 $ per le scritture con durata di cinque minuti e 4 $ per le scritture con durata di un'ora; la tariffa del catalogo Kunavo per la lettura dalla cache dello stesso modello è $0,14. Le scritture nella cache Claude di Kunavo vengono fatturate a 1,25 volte la tariffa di input. Queste tariffe di fatturazione non dimostrano che ogni percorso OpenClaw utilizzi il caching: verifica l'utilizzo restituito prima di calcolare il budget dei controlli di routine come riscontri positivi nella cache.

I prezzi di Anthropic includono la finestra di contesto supportata da 1M alle tariffe standard per Sonnet 5 e Opus 5; anche Kunavo non applica un sovrapprezzo per il contesto lungo a questi modelli Claude. Una cronologia più lunga significa comunque più token fatturati. Mantieni delimitati i controlli ricorrenti e includi separatamente input nuovi, scritture nella cache, letture dalla cache e output in una stima mensile.

Quando OpenRouter, il gratuito o il locale sono acquisti migliori

Scegli OpenRouter quando devi confrontare famiglie di modelli o controllare le preferenze dei provider upstream. La sua documentazione sul routing supporta priorità come prezzo, latenza e throughput. Seleziona un modello concreto e controlla i suoi prezzi attuali invece di presumere che un routing automatico scelga sempre il risultato accettabile più economico.

Usa gli endpoint gratuiti per l'esplorazione iniziale o per il lavoro non urgente. OpenRouter documenta i limiti delle richieste dei modelli gratuiti, quindi un prezzo per token pari a zero non dimostra una capacità sufficiente per un assistente sempre attivo. Evita di far dipendere una routine sensibile ai tempi da una quota che non hai verificato.

Scegli l'inferenza locale quando l'hardware è già disponibile e gestirlo è accettabile. La configurazione Ollama di OpenClaw verifica le capacità dei modelli, incluso il supporto agli strumenti. Un modello che chatta bene ma non può eseguire il flusso di lavoro richiesto dagli strumenti non è un vero affare per quell'attività.

Acquista un percorso funzionante prima di aggiungere complessità di fallback

Scegli innanzitutto il ruolo del modello e il provider. Conferma con un'attività delimitata l'ID del modello, l'endpoint, lo streaming, le chiamate agli strumenti e la reportistica sull'utilizzo. Poi aggiungi percorsi di fallback con un budget noto; altrimenti un errore può spostare silenziosamente il lavoro su un livello diverso di prezzo o capacità.

Configura un percorso Kunavo in OpenClaw

Questa è una configurazione iniziale di solo testo basata sullo schema dei provider personalizzati di OpenClaw e sull'endpoint Messages di Kunavo. Qui non è stata convalidata con un'attività OpenClaw a pagamento. Mantieni disponibile il percorso attualmente funzionante durante la prova.

1. Crea una chiave Kunavo in API keys e finanzia l'account in billing quando sei pronto a inviare richieste a pagamento.
2. Imposta KUNAVO_API_KEY nell'ambiente del gateway. OpenClaw legge anche ~/.openclaw/.env, dove puoi aggiungere KUNAVO_API_KEY=your-key; una variabile di processo esistente ha la precedenza. Consulta il riferimento sull'ambiente. Tieni la chiave reale fuori dai file di progetto.
3. Esegui il backup della configurazione, quindi unisci i campi riportati sotto in ~/.openclaw/openclaw.json, preservando gli altri provider, agenti e canali. La guida alla configurazione illustra i percorsi dei file non predefiniti.

{
  "models": {
    "mode": "merge",
    "providers": {
      "kunavo": {
        "baseUrl": "https://api.kunavo.com",
        "apiKey": "${KUNAVO_API_KEY}",
        "api": "anthropic-messages",
        "authHeader": true,
        "models": [
          {
            "id": "claude-haiku-4-5",
            "name": "Claude Haiku 4.5",
            "input": [
              "text"
            ],
            "contextWindow": 200000,
            "maxTokens": 1024
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "kunavo/claude-haiku-4-5"
      }
    }
  }
}

L'URL di base è l'origine: questo adapter aggiunge /v1/messages. Il prefisso kunavo/ identifica il provider OpenClaw; l'ID del modello della richiesta resta claude-haiku-4-5. Qui 1024 è un limite di output deliberatamente ridotto per la prima prova, non il massimo nativo del modello. L'esempio dichiara solo input testuale.

openclaw config validate
openclaw gateway restart
openclaw models list --provider kunavo

La convalida della configurazione controlla la configurazione, mentre la lista dei modelli controlla il catalogo caricato; nessuna delle due dimostra che un'attività a pagamento funzioni. Riavvia prima della lista, così un gateway in esecuzione carica il nuovo provider. Apri una sessione nuova e conferma il modello attivo: una sessione o un agente esistente possono conservare una sovrascrittura del valore predefinito.

Per la prima attività, chiedigli di leggere un piccolo README temporaneo e riassumerlo, quindi poni una domanda di approfondimento su quel file. Controlla il risultato dello strumento, lo streaming della risposta e l'addebito registrato in Kunavo prima di spostare il lavoro pianificato. Un 401 richiede di controllare la chiave nell'ambiente del gateway; un errore di modello non trovato richiede di controllare il prefisso del provider e l'ID del modello. L'assenza di metadati locali sui costi può mostrare una stima pari a zero anche quando il provider ha fatturato la richiesta.

Domande frequenti

Documentazione ufficiale verificata il 17 settembre 2026. Le tariffe Kunavo e i totali illustrativi sono calcolati dal catalogo live dei modelli.