Providers
DeepSeek
DeepSeek fornisce potenti modelli di IA con un'API compatibile con OpenAI.
| Proprietà | Valore |
|---|---|
| Provider | deepseek |
| Autenticazione | DEEPSEEK_API_KEY |
| API | compatibile con OpenAI |
| URL di base | https://api.deepseek.com |
Per iniziare
Ottieni la tua chiave API
Crea una chiave API su platform.deepseek.com.
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.
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
Configurazione non interattiva
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
Catalogo integrato
| Rif. modello | Nome | Input | Contesto | Output max | Note |
|---|---|---|---|---|---|
deepseek/deepseek-v4-flash |
DeepSeek V4 Flash | text | 1,000,000 | 384,000 | Modello predefinito; interfaccia V4 con supporto al ragionamento |
deepseek/deepseek-v4-pro |
DeepSeek V4 Pro | text | 1,000,000 | 384,000 | Interfaccia V4 con supporto al ragionamento |
deepseek/deepseek-chat |
DeepSeek Chat | text | 131,072 | 8,192 | Interfaccia DeepSeek V3.2 senza ragionamento |
deepseek/deepseek-reasoner |
DeepSeek Reasoner | text | 131,072 | 65,536 | Interfaccia V3.2 con ragionamento abilitato |
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" },
},
},
}