Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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
Questo richiederà la tua chiave API e imposterà deepseek/deepseek-v4-flash come modello predefinito.
3

Verifica che i modelli siano disponibili

openclaw models list --provider deepseek
Per esaminare il catalogo statico incluso senza richiedere un Gateway in esecuzione, usa:
openclaw models list --all --provider deepseek
Per installazioni automatizzate o headless, 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 il 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 Flashtext1,000,000384,000Modello predefinito; interfaccia V4 con supporto al ragionamento
deepseek/deepseek-v4-proDeepSeek V4 Protext1,000,000384,000Interfaccia V4 con supporto al ragionamento
deepseek/deepseek-chatDeepSeek Chattext131,0728,192Interfaccia DeepSeek V3.2 senza ragionamento
deepseek/deepseek-reasonerDeepSeek Reasonertext131,07265,536Interfaccia V3.2 con ragionamento abilitato
I modelli V4 supportano il controllo thinking di DeepSeek. OpenClaw riproduce anche DeepSeek reasoning_content nei turni successivi, così le sessioni di ragionamento con chiamate agli strumenti possono continuare. Usa /think xhigh o /think max con i modelli DeepSeek V4 per richiedere il reasoning_effort massimo di DeepSeek.

Ragionamento e strumenti

Le sessioni di ragionamento DeepSeek V4 hanno un contratto di riproduzione più rigoroso rispetto alla maggior parte dei provider compatibili con OpenAI: dopo che un turno con ragionamento abilitato usa strumenti, DeepSeek si aspetta che i messaggi assistant riprodotti da quel turno includano reasoning_content nelle richieste successive. OpenClaw gestisce questo nel Plugin DeepSeek, quindi il normale uso degli 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 agli strumenti dell’assistant potrebbero non avere reasoning_content nativo di DeepSeek. OpenClaw compila quel campo mancante nei messaggi assistant riprodotti per le richieste di ragionamento DeepSeek V4, così il provider può accettare la cronologia senza richiedere /new. Quando il ragionamento è disabilitato in OpenClaw (inclusa la selezione UI Nessuno), OpenClaw invia a DeepSeek thinking: { type: "disabled" } e rimuove reasoning_content riprodotto dalla cronologia in uscita. Questo mantiene le sessioni con ragionamento disabilitato sul percorso DeepSeek senza ragionamento. Usa deepseek/deepseek-v4-flash per il percorso veloce predefinito. Usa deepseek/deepseek-v4-pro quando vuoi il modello V4 più potente e puoi accettare costi o latenza maggiori.

Test live

La suite diretta dei modelli live include DeepSeek V4 nel set di modelli moderno. 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
Quel controllo live verifica che entrambi i modelli V4 possano completare e che i turni successivi con ragionamento/strumenti preservino il payload di riproduzione richiesto da DeepSeek.

Esempio di configurazione

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

Correlati

Selezione del modello

Scelta di provider, riferimenti dei modelli e comportamento di failover.

Riferimento della configurazione

Riferimento completo della configurazione per agenti, modelli e provider.