Providers
DeepSeek
DeepSeek fornisce potenti modelli di IA con un'API compatibile con OpenAI.
| Proprietà | Valore |
|---|---|
| Provider | deepseek |
| Auth | DEEPSEEK_API_KEY |
| API | compatibile con OpenAI |
| URL di base | https://api.deepseek.com |
Installa Plugin
Installa il Plugin ufficiale, poi riavvia Gateway:
openclaw plugins install @openclaw/deepseek-provideropenclaw gateway restartPer iniziare
Ottieni la tua chiave API
Crea una chiave API su platform.deepseek.com.
Esegui l'onboarding
openclaw onboard --auth-choice deepseek-api-keyVerrà richiesta la tua chiave API e deepseek/deepseek-v4-flash verrà impostato come modello predefinito.
Verifica che i modelli siano disponibili
openclaw models list --provider deepseekPer ispezionare il catalogo statico del Plugin senza richiedere un Gateway in esecuzione, usa:
openclaw models list --all --provider deepseekConfigurazione non interattiva
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-riskCatalogo integrato
| Rif. modello | Nome | Input | Contesto | Output max | Note |
|---|---|---|---|---|---|
deepseek/deepseek-v4-flash |
DeepSeek V4 Flash | testo | 1.000.000 | 384.000 | Modello predefinito; superficie V4 con capacità di thinking |
deepseek/deepseek-v4-pro |
DeepSeek V4 Pro | testo | 1.000.000 | 384.000 | Superficie V4 con capacità di thinking |
deepseek/deepseek-chat |
DeepSeek Chat | testo | 131.072 | 8.192 | Superficie DeepSeek V3.2 senza thinking |
deepseek/deepseek-reasoner |
DeepSeek Reasoner | testo | 131.072 | 65.536 | Superficie V3.2 con reasoning abilitato |
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.tsQuesto 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" }, }, },}