Pular para o conteúdo principal
DeepSeek fornece modelos de IA poderosos com uma API compatível com OpenAI.
PropriedadeValor
Provedordeepseek
AutenticaçãoDEEPSEEK_API_KEY
APIcompatível com OpenAI
URL basehttps://api.deepseek.com

Instalar Plugin

Instale o Plugin oficial e reinicie o Gateway:
openclaw plugins install @openclaw/deepseek-provider
openclaw gateway restart

Primeiros passos

1

Get your API key

Crie uma chave de API em platform.deepseek.com.
2

Run onboarding

openclaw onboard --auth-choice deepseek-api-key
Isso solicitará sua chave de API e definirá deepseek/deepseek-v4-flash como o modelo padrão.
3

Verify models are available

openclaw models list --provider deepseek
Para inspecionar o catálogo estático do Plugin sem exigir um Gateway em execução, use:
openclaw models list --all --provider deepseek
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-risk
Se o Gateway for executado como daemon (launchd/systemd), garanta que DEEPSEEK_API_KEY esteja disponível para esse processo (por exemplo, em ~/.openclaw/.env ou via env.shellEnv).

Catálogo integrado

Ref. do modeloNomeEntradaContextoSaída máximaObservações
deepseek/deepseek-v4-flashDeepSeek V4 Flashtexto1,000,000384,000Modelo padrão; superfície V4 compatível com thinking
deepseek/deepseek-v4-proDeepSeek V4 Protexto1,000,000384,000Superfície V4 compatível com thinking
deepseek/deepseek-chatDeepSeek Chattexto131,0728,192Superfície DeepSeek V3.2 sem thinking
deepseek/deepseek-reasonerDeepSeek Reasonertexto131,07265,536Superfície V3.2 com raciocínio habilitado
Modelos V4 oferecem suporte ao controle thinking da DeepSeek. O OpenClaw também reproduz o reasoning_content da DeepSeek em turnos de acompanhamento para que sessões de thinking com chamadas de ferramentas possam continuar. Use /think xhigh ou /think max com modelos DeepSeek V4 para solicitar o reasoning_effort máximo da DeepSeek.

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.ts
Essa 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" },
    },
  },
}

Relacionados

Model selection

Escolha de provedores, refs de modelo e comportamento de failover.

Configuration reference

Referência completa de configuração para agentes, modelos e provedores.