Providers
DeepSeek
DeepSeek fornece modelos de IA poderosos com uma API compatível com OpenAI.
| Propriedade | Valor |
|---|---|
| Provedor | deepseek |
| Autenticação | DEEPSEEK_API_KEY |
| API | compatível com OpenAI |
| URL base | https://api.deepseek.com |
Instalar Plugin
Instale o Plugin oficial e reinicie o Gateway:
openclaw plugins install @openclaw/deepseek-provideropenclaw gateway restartPrimeiros passos
Get your API key
Crie uma chave de API em platform.deepseek.com.
Run onboarding
openclaw onboard --auth-choice deepseek-api-keyIsso solicitará sua chave de API e definirá deepseek/deepseek-v4-flash como o modelo padrão.
Verify models are available
openclaw models list --provider deepseekPara inspecionar o catálogo estático do Plugin sem exigir um Gateway em execução, use:
openclaw models list --all --provider deepseekNon-interactive setup
Para instalações com script ou sem interface gráfica, passe todas as flags diretamente:
openclaw onboard --non-interactive \ --mode local \ --auth-choice deepseek-api-key \ --deepseek-api-key "$DEEPSEEK_API_KEY" \ --skip-health \ --accept-riskCatálogo integrado
| Ref. do modelo | Nome | Entrada | Contexto | Saída máxima | Observações |
|---|---|---|---|---|---|
deepseek/deepseek-v4-flash |
DeepSeek V4 Flash | texto | 1,000,000 | 384,000 | Modelo padrão; superfície V4 compatível com thinking |
deepseek/deepseek-v4-pro |
DeepSeek V4 Pro | texto | 1,000,000 | 384,000 | Superfície V4 compatível com thinking |
deepseek/deepseek-chat |
DeepSeek Chat | texto | 131,072 | 8,192 | Superfície DeepSeek V3.2 sem thinking |
deepseek/deepseek-reasoner |
DeepSeek Reasoner | texto | 131,072 | 65,536 | Superfície V3.2 com raciocínio habilitado |
Thinking e ferramentas
Sessões de thinking do DeepSeek V4 têm um contrato de reprodução mais rigoroso do que a maioria dos
provedores compatíveis com OpenAI: depois que um turno com thinking habilitado usa ferramentas, a DeepSeek
espera que as mensagens de assistente reproduzidas desse turno incluam
reasoning_content em solicitações de acompanhamento. O OpenClaw trata isso dentro do
Plugin DeepSeek, então o uso normal de ferramentas em vários turnos funciona com
deepseek/deepseek-v4-flash e deepseek/deepseek-v4-pro.
Se você alternar uma sessão existente de outro provedor compatível com OpenAI para um
modelo DeepSeek V4, turnos anteriores de chamadas de ferramenta do assistente talvez não tenham
reasoning_content nativo da DeepSeek. O OpenClaw preenche esse campo ausente em mensagens
de assistente reproduzidas para solicitações de thinking do DeepSeek V4, para que o provedor possa aceitar
o histórico sem exigir /new.
Quando o thinking está desabilitado no OpenClaw (incluindo a seleção None na UI),
o OpenClaw envia thinking: { type: "disabled" } à DeepSeek e remove
reasoning_content reproduzido do histórico de saída. Isso mantém sessões com thinking desabilitado
no caminho sem thinking da DeepSeek.
Use deepseek/deepseek-v4-flash para o caminho rápido padrão. Use
deepseek/deepseek-v4-pro quando quiser o modelo V4 mais forte e puder aceitar
maior custo ou latência.
Testes ao vivo
A suíte direta de modelos ao vivo inclui DeepSeek V4 no conjunto de modelos moderno. Para executar apenas as verificações diretas de modelo do 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.tsEssa verificação ao vivo valida que ambos os modelos V4 conseguem concluir e que turnos de acompanhamento com thinking/ferramentas preservam o payload de reprodução exigido pela DeepSeek.
Exemplo de configuração
{ env: { DEEPSEEK_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "deepseek/deepseek-v4-flash" }, }, },}