OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

DeepSeek

DeepSeek fornisce potenti modelli di IA tramite un'API compatibile con OpenAI.

Proprietà Valore
Fornitore deepseek
Autenticazione DEEPSEEK_API_KEY
API Compatibile con OpenAI
URL di base https://api.deepseek.com

Installare il Plugin

Installa il Plugin ufficiale, quindi riavvia il Gateway:

bash
openclaw plugins install @openclaw/deepseek-provideropenclaw gateway restart

Guida introduttiva

  • Ottieni la chiave API

    Crea una chiave API su platform.deepseek.com.

  • Esegui la configurazione iniziale

    bash
    openclaw onboard --auth-choice deepseek-api-key

    Richiede la chiave API e imposta deepseek/deepseek-v4-flash come modello predefinito.

  • Verifica che i modelli siano disponibili

    bash
    openclaw models list --provider deepseek

    Per esaminare il catalogo statico del Plugin senza un Gateway in esecuzione:

    bash
    openclaw models list --all --provider deepseek
    • Configurazione non interattiva

    Per le installazioni tramite script o senza interfaccia grafica, passa direttamente tutte le opzioni:

    bash
    openclaw onboard --non-interactive \  --mode local \  --auth-choice deepseek-api-key \  --deepseek-api-key "$DEEPSEEK_API_KEY" \  --skip-health \  --accept-risk

    Catalogo integrato

    Riferimento modello Nome Input Contesto Output massimo Note
    deepseek/deepseek-v4-flash DeepSeek V4 Flash testo 1,000,000 384,000 Modello predefinito; interfaccia V4 con capacità di ragionamento
    deepseek/deepseek-v4-pro DeepSeek V4 Pro testo 1,000,000 384,000 Interfaccia V4 con capacità di ragionamento
    deepseek/deepseek-chat DeepSeek Chat testo 1,000,000 384,000 Nome di compatibilità deprecato per V4 Flash senza ragionamento
    deepseek/deepseek-reasoner DeepSeek Reasoner testo 1,000,000 384,000 Nome di compatibilità deprecato per V4 Flash con ragionamento

    Le stime locali dei costi di OpenClaw seguono le tariffe pubblicate da DeepSeek per riscontri nella cache, riscontri mancati nella cache e output. DeepSeek può modificare tali tariffe; la pagina Modelli e prezzi è la fonte autorevole per la fatturazione.

    Ragionamento e strumenti

    Nelle sessioni di ragionamento di DeepSeek V4, i messaggi dell'assistente riprodotti da un turno con ragionamento abilitato devono includere reasoning_content nelle richieste successive. Il Plugin DeepSeek di OpenClaw compila automaticamente tale campo, quindi il normale utilizzo degli strumenti su più turni funziona con deepseek/deepseek-v4-flash e deepseek/deepseek-v4-pro anche quando la cronologia proviene da un altro fornitore compatibile con OpenAI (senza reasoning_content nativo) o da un semplice messaggio dell'assistente. Non è necessario usare /new dopo aver cambiato fornitore durante una sessione.

    Quando il ragionamento è disabilitato (inclusa la selezione None nell'interfaccia), OpenClaw invia thinking: { type: "disabled" } e rimuove il reasoning_content riprodotto dalla cronologia in uscita, mantenendo la sessione sul percorso DeepSeek senza ragionamento.

    Usa deepseek/deepseek-v4-flash come percorso rapido predefinito. Usa deepseek/deepseek-v4-pro per il modello più potente quando puoi accettare costi o latenza maggiori.

    Test dal vivo

    Per eseguire soltanto i controlli diretti dei modelli DeepSeek V4 dalla moderna suite di test dal vivo dei modelli:

    bash
    OPENCLAW_LIVE_PROVIDERS=deepseek \OPENCLAW_LIVE_MODELS="deepseek/deepseek-v4-flash,deepseek/deepseek-v4-pro" \pnpm test:live src/agents/models.profiles.live.test.ts

    Verifica che entrambi i modelli V4 completino l'esecuzione e che i turni successivi con ragionamento e strumenti conservino il payload riprodotto richiesto da DeepSeek.

    Esempio di configurazione

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

    Contenuti correlati

    Selezione del modello

    Scelta dei fornitori, dei riferimenti dei modelli e del comportamento di failover.
    Riferimento della configurazione

    Riferimento completo della configurazione per agenti, modelli e fornitori.
    Was this useful?
    On this page

    On this page