OpenClaw con DeepSeek: configurazione, ID dei modelli e costi API

OpenClaw raggiunge DeepSeek tramite un plugin ufficiale del provider installato separatamente — openclaw plugins install @openclaw/deepseek-provider — con ID provider deepseek, chiave DEEPSEEK_API_KEY, un'API compatibile con OpenAI e URL di base https://api.deepseek.com senza /v1. Due fatti determinano il successo della prima esecuzione. Il catalogo attivo di DeepSeek contiene due soli ID, deepseek-flash e deepseek-v4-pro; i nomi deepseek-chat e deepseek-reasoner utilizzati dai tutorial meno recenti sono stati dismessi il 24 luglio 2026. Inoltre, la procedura di onboarding di OpenClaw imposta deepseek/deepseek-v4-pro come predefinito, ovvero l'unico modello sulla cui fatturazione attuale le pagine ufficiali di DeepSeek non concordano.

Un chiarimento prima della configurazione, perché i risultati di ricerca li mescolano. Un diverso OpenClaw su GitHub si descrive come "a multiplatform C++ reimplementation of original Captain Claw (1997) platformer game"; nulla di quel progetto si applica qui. L'agente è il progetto disponibile su openclaw.ai, documentato su docs.openclaw.ai: collega quel dominio, poiché documentation.openclaw.ai vi reindirizza soltanto.

Installalo e configuralo nel modo documentato da entrambi i progetti

# 1. Install the provider plugin — DeepSeek support is not bundled.
openclaw plugins install @openclaw/deepseek-provider

# 2. Interactive: prompts for the key, sets deepseek/deepseek-v4-pro as default.
openclaw onboard --auth-choice deepseek-api-key

# 2b. Or scripted, with the flags OpenClaw documents for a headless install.
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk

Con il plugin installato non devi fornire un URL di base: il plugin pubblica il proprio catalogo e il proprio comportamento di compatibilità. Una configurazione minima comprende la chiave e il modello, in JSON5.

{
  env: { vars: { DEEPSEEK_API_KEY: "sk-..." } },
  agents: {
    defaults: {
      model: { primary: "deepseek/deepseek-v4-pro" },
    },
  },
}

OpenClaw risolve una chiave del provider da quattro forme di variabili d'ambiente secondo un ordine di priorità documentato: OPENCLAW_LIVE_DEEPSEEK_KEY come singola sostituzione attiva con la priorità più alta, poi DEEPSEEK_API_KEYS come elenco separato da virgole o punto e virgola, quindi DEEPSEEK_API_KEY come chiave primaria, infine le voci numerate DEEPSEEK_API_KEY_* (Interfaccia di controllo e chiavi, verificato il 21 settembre 2026). La sezione Settings, quindi Models, nell'interfaccia di controllo aggiunge o sostituisce le chiavi senza modificare il file, e il materiale della chiave rimane nell'archivio di autenticazione. Il problema di un'installazione server riguarda l'ambito, non la sintassi: la pagina di OpenClaw avverte che, se il Gateway viene eseguito come daemon tramite launchd o systemd, la chiave deve essere visibile a quel processo, ad esempio in ~/.openclaw/.env o tramite env.shellEnv.

Quali ID dei modelli DeepSeek sono effettivamente attivi

Le righe seguenti riportano tre stati diversi, non uno solo. La risposta di esempio nel riferimento list-models di DeepSeek mostra esattamente due ID, deepseek-flash e deepseek-v4-pro, mentre il catalogo incluso in OpenClaw offre ancora quattro riferimenti.

Mantieni separate le due dichiarazioni sul ritiro, perché sembrano contraddittorie ma non lo sono. OpenClaw dichiara che DeepSeek ha ritirato deepseek-chat e deepseek-reasoner e che "quegli ID di modello non sono più accessibili". DeepSeek dichiara separatamente che "i nomi precedenti deepseek-v4-flash e deepseek-v4-flash-vision-exp sono ancora accettati, ma i modelli corrispondenti sono stati ritirati". Sono due coppie diverse di nomi, con due esiti diversi. La pagina Models & Pricing di DeepSeek assegna a entrambi gli ID attivi una finestra di contesto di 1M e un output massimo di 384K, mentre la tabella del catalogo di OpenClaw riporta la stessa coppia 1.000.000 / 384.000 per tutti e quattro i riferimenti.

Quello ancora irrisolto. L'annuncio del 10 settembre 2026 di DeepSeek afferma "We're phasing out V4-Pro" e che "starting at 04:00 UTC on Sept 14, 2026, all deepseek-v4-pro requests will route to V4.1-Flash at V4.1-Flash rates". Il changelog dello stesso rilascio afferma l'opposto: "in response to user demand, we have decided to continue providing API services for DeepSeek V4 Pro after September 14, 2026, with the billing method remaining unchanged". La pagina Models & Pricing elenca ancora V4 Pro con le proprie tariffe più elevate e non riporta alcun avviso di ritiro. Entrambe le fonti sono state consultate il 21 settembre 2026, una settimana dopo la data in questione. Questa pagina non ti dirà quale tariffa viene applicata: confermalo nel tuo account DeepSeek prima di lasciare attivo il modello predefinito dell'onboarding e nota che il predefinito è proprio il modello contestato.

Quanto costano i token e perché l'orario fa parte del prezzo

DeepSeek pubblica tariffe di punta e non di punta, con la fascia non di punta pari alla metà di quella di punta. La finestra è ristretta: "peak hours are 01:00 - 04:00 and 06:00 - 10:00 UTC, Monday through Friday, excluding Chinese public holidays. All other hours are off-peak, including weekends and Chinese public holidays in full." Sette ore dei giorni feriali sono di punta e tutto il resto non lo è; pertanto, una stima che presuppone silenziosamente la fascia di punta sovrastima una fattura tipica.

Consultato sulla pagina Models & Pricing di DeepSeek il 21 settembre 2026. La riga Flash è corroborata indipendentemente dalla pagina del provider OpenClaw, che indica "$0,30 per million input tokens, $1,20 per million output tokens, and $0,006 per million cached input tokens". Le righe V4 Pro si basano esclusivamente sulla pagina Models & Pricing e rientrano nella contraddizione descritta sopra; trattale quindi come valori riportati, non definitivi.

La colonna della cache è quella che incide sulla fattura di un agente e il suo rapporto è insolito. Un accesso alla cache su deepseek-flash costa $0,006 per milione contro $0,30 per un mancato accesso, cioè circa un cinquantesimo della tariffa senza accesso, molto meno del rapporto di un decimo comune altrove; non trasferire quindi un'ipotesi da un altro fornitore. La guida al caching di DeepSeek afferma che la funzionalità "is enabled by default for all users, without needing to modify their code", che un accesso riuscito richiede un prefisso completamente corrispondente e che una cache inutilizzata viene cancellata "usually within a few hours to a few days". Gli accessi riusciti e quelli mancati vengono restituiti nei campi di utilizzo prompt_cache_hit_tokens e prompt_cache_miss_tokens. DeepSeek non pubblica alcun prezzo per la scrittura in cache e la sua tabella dei prezzi non contiene una colonna per la scrittura in cache; si tratta di una tariffa pubblicata assente, non dell'affermazione che le scritture siano gratuite.

Una sessione illustrativa su deepseek-flash, alle tariffe pubblicate da DeepSeek. Supponi un'esecuzione di OpenClaw che invia 600.000 token di input, di cui 450.000 trovano una corrispondenza nella cache del prefisso e 150.000 no, e riceve 40.000 token di output. In fascia di punta il costo è $0,045 più $0,0027 più $0,048, ovvero $0,096; la stessa sessione in fascia non di punta costa $0,048. La stessa esecuzione senza alcuna corrispondenza nella cache costerebbe $0,228 in fascia di punta. Si tratta di calcoli sui token basati sulle ipotesi dichiarate, non di costi misurati di un'attività né di un limite di spesa: la variabile più importante è la quota di token che trovano una corrispondenza nella cache nella tua esecuzione, e il valore mostrato nell'app di OpenClaw non permette di determinarla, perché OpenClaw dichiara che i costi locali sono stime e indica la pagina dei prezzi di DeepSeek come fonte autorevole per la fatturazione.

La capacità del modello e il supporto agli strumenti del client sono due domande diverse

Questa è la parte che una tabella dei prezzi non può dirti ed è il motivo pratico per utilizzare il plugin invece di una voce del provider creata manualmente. Le sessioni di ragionamento DeepSeek V4 richiedono che i messaggi assistant riprodotti da un turno abilitato al ragionamento portino reasoning_content nelle richieste successive. Il plugin DeepSeek di OpenClaw reinserisce automaticamente quel campo, così l'uso degli strumenti su più turni funziona "even when history came from another OpenAI-compatible provider (no native reasoning_content) or from a plain assistant message", senza bisogno di /new dopo il passaggio da un provider all'altro nel corso della sessione. Quando il ragionamento è disattivato, inclusa la selezione None dell'interfaccia, OpenClaw invia thinking: { type: "disabled" } e rimuove i reasoning_content riprodotti dalla cronologia in uscita. OpenClaw associa inoltre sia /think xhigh sia /think max al valore massimo reasoning_effort di DeepSeek.

Un provider personalizzato generico openai-completions indirizzato a un endpoint compatibile con DeepSeek non riceve nulla di questo reinserimento automatico e non utilizza alcun formato di ragionamento DeepSeek, a meno che tu non dichiari autonomamente il blocco di compatibilità: la pagina ds4 di OpenClaw mostra la struttura, inclusi thinkingFormat: "deepseek" e supportsReasoningEffort. Questa lacuna è la spiegazione consueta di un turno con strumenti che riesce una volta e poi fallisce al turno successivo.

Due limiti lato DeepSeek rientrano nella stessa decisione. La chiamata agli strumenti in modalità strict si trova su un URL di base diverso, https://api.deepseek.com/beta, e richiede "strict": true per ogni funzione oltre a "additionalProperties": false; non è l'endpoint a cui il plugin indirizza per impostazione predefinita. Inoltre, la guida di DeepSeek alle chiamate degli strumenti afferma che "the Chat Completion API does not support inserting tool calls mid-conversation but does support inserting system messages mid-conversation; to insert tool calls, use the Anthropic API or the Responses API instead": un limite dell'endpoint utilizzato dal plugin di OpenClaw, con due alternative documentate anziché una limitazione del modello.

Per quanto riguarda il supporto dei modelli, le due fonti concordano. La colonna FEATURES della pagina Models & Pricing di DeepSeek indica Tool Calls, JSON Output, Responses API e Anthropic API come supportati sia su deepseek-flash sia su deepseek-v4-pro, e li distingue per la visione: supportata su deepseek-flash, non supportata su deepseek-v4-pro. OpenClaw dichiara che l'uso degli strumenti su più turni funziona su tutti e quattro i suoi riferimenti. Nessuna delle due fonti documenta le chiamate parallele agli strumenti, quindi questo aspetto rimane realmente aperto e non è risolto in alcun senso.

Verifica in tre passaggi, poi gli errori che vale la pena nominare

Controlla i livelli in ordine, perché ciascuno fallisce in modo diverso. Primo, il catalogo: openclaw models list --provider deepseek, oppure openclaw models list --all --provider deepseek per esaminare il catalogo statico del plugin senza un Gateway in esecuzione; quindi openclaw models set deepseek/deepseek-flash se vuoi il modello non contestato invece di quello predefinito dell'onboarding. Secondo, un breve prompt non in streaming e poi uno in streaming, che è il punto in cui un problema di autenticazione o di URL di base emerge con chiarezza. Terzo, e solo terzo, una chiamata a uno strumento seguita da un secondo turno nella stessa sessione: è l'unico passaggio che esercita il reinserimento di reasoning_content descritto sopra.

La riga del 404 merita una frase a parte, perché è quella che la documentazione non può spiegarti. La tabella dei codici di errore di DeepSeek elenca 400, 401, 402, 422, 429, 500 e 503 e non contiene 404; pertanto, un 404 qui è una prova relativa al tuo instradamento, non a DeepSeek. Ciò che DeepSeek restituisce effettivamente per un ID modello sconosciuto non è documentato e non è stato testato qui. Il riferimento agli errori tratta i codici di stato equivalenti sull'endpoint di Kunavo.

Diretto, gateway, locale: quale percorso prevale

Kunavo non offre alcun modello DeepSeek. I suoi modelli testuali appartengono alle famiglie Claude e OpenAI, quindi non esiste un percorso Kunavo verso un modello DeepSeek e questa pagina non ne offre uno. Ciò che si trasferisce è il meccanismo, utile da conoscere se stai leggendo una pagina di configurazione DeepSeek perché vuoi una sola chiave tra famiglie di modelli anziché DeepSeek in particolare.

Per la riga del gateway, la configurazione comprende le stesse due leve. Puoi dichiarare models.providers.<id> con baseUrl, apiKey, api: "openai-completions" e un array models[] che elenchi almeno ogni id, oppure eseguire l'onboarding sull'endpoint con --auth-choice custom-api-key, --custom-base-url e --custom-model-id. I riferimenti ai modelli sono sempre provider/model e il problema silenzioso consiste nel sottoporre ad alias un modello in agents.defaults.models senza registrarlo in models.providers.<provider>.models[]: il riferimento ai provider personalizzati di OpenClaw afferma che l'alias "neither restricts overrides nor registers a new runtime model by itself". L'URL di base di Kunavo per questo percorso è https://api.kunavo.com/v1, con esattamente un /v1: l'opposto della convenzione di DeepSeek senza suffisso e la fonte più probabile di un 404 quando qualcuno copia il valore di una pagina nel campo dell'altra.

Per avere un'idea delle proporzioni di questa alternativa, ecco la stessa forma di sessione ipotizzata: 600.000 token di input e 40.000 token di output, senza considerare la cache, valorizzata alle tariffe attive del catalogo Kunavo. Si tratta di modelli diversi su un endpoint diverso, quindi è un confronto di forma e non un confronto del costo della stessa attività con i valori DeepSeek sopra; la tariffa minima elencata e il costo più basso per completare un'attività sono affermazioni separate, e solo la tua esecuzione può determinare la seconda.

Calcolo illustrativo dei token basato sulle ipotesi dichiarate, non costo misurato di un'attività né limite della fattura. L'importo del catalogo Kunavo è una soglia di fatturazione, non un tetto: quando il fornitore upstream comunica il proprio costo, la fattura è il maggiore tra il costo del catalogo e il costo upstream moltiplicato per il markup applicabile. I costi della cache e degli strumenti esterni non rientrano in questo esempio. La ricarica minima è $10 di credito prepagato: un minimo di finanziamento, non una tariffa per attività né un abbonamento. Consulta i dettagli sulla fatturazione e il caching.

Se è proprio il percorso adiacente che desideri, inizia dalla panoramica delle integrazioni per l'URL di base e la configurazione della chiave, quindi consulta il quickstart per una prima chiamata e crea un account Kunavo quando sei pronto a finanziare una chiave. Consideralo un riferimento di configurazione pubblicato, non un risultato di compatibilità: OpenClaw non è stato testato in fase di esecuzione contro l'endpoint di Kunavo. Vuoi rimanere su OpenClaw e scegliere un modello? Prezzi di OpenClaw separa il software gratuito dalla fattura a consumo, migliore API per OpenClaw confronta i percorsi in base all'attività e API compatibile con OpenAI tratta le convenzioni degli URL di base che questa pagina continua ad avvertire di non confondere.

Domande frequenti

Ogni affermazione su OpenClaw e DeepSeek riportata sopra è stata letta nella documentazione e nei registri ufficiali dei rispettivi progetti il 21 settembre 2026, con OpenClaw v2026.9.5; la pagina del provider, la pagina dei prezzi, il changelog, l'annuncio del 10 settembre, il riferimento list-models, la tabella dei codici di errore, la pagina sui limiti di frequenza e le regole sui provider personalizzati sono state recuperate nuovamente e direttamente per questa pagina. Non è stato installato, configurato né chiamato nulla: nessuna esecuzione di OpenClaw, nessuna richiesta ad api.deepseek.com e nessun test in fase di esecuzione contro Kunavo. Le tariffe dei token di Kunavo provengono dal catalogo attivo e ogni importo in dollari è un calcolo illustrativo sui token, non un costo misurato.