Vai al contenuto principale
DeepSeek fornisce potenti modelli di IA con un’API compatibile con OpenAI.
ProprietàValore
Providerdeepseek
AuthDEEPSEEK_API_KEY
APIcompatibile con OpenAI
URL di basehttps://api.deepseek.com

​
Installa Plugin

Installa il Plugin ufficiale, poi riavvia Gateway: 
openclaw plugins install @openclaw/deepseek-provider
openclaw gateway restart

​
Per iniziare

1

Ottieni la tua chiave API

Crea una chiave API su platform.deepseek.com.
2

Esegui l'onboarding

openclaw onboard --auth-choice deepseek-api-key
Verrà richiesta la tua chiave API e deepseek/deepseek-v4-flash verrà impostato come modello predefinito.
3

Verifica che i modelli siano disponibili

openclaw models list --provider deepseek
Per ispezionare il catalogo statico del Plugin senza richiedere un Gateway in esecuzione, usa:
openclaw models list --all --provider deepseek
Per installazioni con script o senza interfaccia, passa direttamente tutti i flag:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk
Se Gateway viene eseguito come daemon (launchd/systemd), assicurati che DEEPSEEK_API_KEY sia disponibile per quel processo (ad esempio in ~/.openclaw/.env o tramite env.shellEnv).

​
Catalogo integrato

Rif. modelloNomeInputContestoOutput maxNote
deepseek/deepseek-v4-flashDeepSeek V4 Flashtesto1.000.000384.000Modello predefinito; superficie V4 con capacità di thinking
deepseek/deepseek-v4-proDeepSeek V4 Protesto1.000.000384.000Superficie V4 con capacità di thinking
deepseek/deepseek-chatDeepSeek Chattesto131.0728.192Superficie DeepSeek V3.2 senza thinking
deepseek/deepseek-reasonerDeepSeek Reasonertesto131.07265.536Superficie V3.2 con reasoning abilitato
I modelli V4 supportano il controllo thinking di DeepSeek. OpenClaw riproduce anche reasoning_content di DeepSeek nei turni successivi, così le sessioni di thinking con chiamate agli strumenti possono continuare. Usa /think xhigh o /think max con i modelli DeepSeek V4 per richiedere il massimo reasoning_effort di DeepSeek.

​
Thinking e strumenti

Le sessioni di thinking DeepSeek V4 hanno un contratto di replay più rigoroso rispetto alla maggior parte dei provider compatibili con OpenAI: dopo che un turno con thinking abilitato usa strumenti, DeepSeek si aspetta che i messaggi assistente riprodotti da quel turno includano reasoning_content nelle richieste successive. OpenClaw gestisce questo all’interno del Plugin DeepSeek, quindi il normale uso di strumenti multi-turno funziona con deepseek/deepseek-v4-flash e deepseek/deepseek-v4-pro. Se passi una sessione esistente da un altro provider compatibile con OpenAI a un modello DeepSeek V4, i turni precedenti di chiamata strumento dell’assistente potrebbero non avere reasoning_content nativo di DeepSeek. OpenClaw compila quel campo mancante nei messaggi assistente riprodotti per le richieste di thinking DeepSeek V4, così il provider può accettare la cronologia senza richiedere /new. Quando il thinking è disabilitato in OpenClaw (inclusa la selezione Nessuna nell’interfaccia), OpenClaw invia a DeepSeek thinking: { type: "disabled" } e rimuove reasoning_content riprodotto dalla cronologia in uscita. Questo mantiene le sessioni con thinking disabilitato sul percorso DeepSeek senza thinking. Usa deepseek/deepseek-v4-flash per il percorso rapido predefinito. Usa deepseek/deepseek-v4-pro quando vuoi il modello V4 più potente e puoi accettare costi o latenza superiori.

​
Test live

La suite diretta dei modelli live include DeepSeek V4 nel set di modelli moderni. Per eseguire solo i controlli diretti dei modelli DeepSeek V4: 
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
Questo controllo live verifica sia che entrambi i modelli V4 possano completare sia che i turni successivi con thinking/strumenti preservino il payload di replay richiesto da DeepSeek.

​
Esempio di configurazione

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

​
Correlati

Selezione del modello

Scelta dei provider, dei riferimenti modello e del comportamento di failover.

Riferimento di configurazione

Riferimento completo della configurazione per agenti, modelli e provider.