Providers

DeepSeek

DeepSeek fornece modelos avançados de IA com uma API compatível com a OpenAI.

Propriedade Valor
Provedor deepseek
Autenticação DEEPSEEK_API_KEY
API Compatível com a OpenAI
URL base https://api.deepseek.com

Instalar o plugin

Instale o plugin oficial e reinicie o Gateway:

bash
openclaw plugins install @openclaw/deepseek-provideropenclaw gateway restart

Primeiros passos

  • Obtenha sua chave de API

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

  • Execute a integração inicial

    bash
    openclaw onboard --auth-choice deepseek-api-key

    Solicita sua chave de API e define deepseek/deepseek-v4-flash como o modelo padrão.

  • Verifique se os modelos estão disponíveis

    bash
    openclaw models list --provider deepseek

    Para consultar o catálogo estático do plugin sem um Gateway em execução:

    bash
    openclaw models list --all --provider deepseek
  • Configuração não interativa

    Para instalações automatizadas por script ou sem interface, passe todos os parâmetros diretamente:

    bash
    openclaw onboard --non-interactive \  --mode local \  --auth-choice deepseek-api-key \  --deepseek-api-key "$DEEPSEEK_API_KEY" \  --skip-health \  --accept-risk

    Catálogo integrado

    Referência 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; interface V4 compatível com raciocínio
    deepseek/deepseek-v4-pro DeepSeek V4 Pro texto 1.000.000 384.000 Interface V4 compatível com raciocínio
    deepseek/deepseek-chat DeepSeek Chat texto 1.000.000 384.000 Nome de compatibilidade obsoleto do V4 Flash sem raciocínio
    deepseek/deepseek-reasoner DeepSeek Reasoner texto 1.000.000 384.000 Nome de compatibilidade obsoleto do V4 Flash com raciocínio

    As estimativas locais de custo do OpenClaw seguem as tarifas publicadas pela DeepSeek para acertos de cache, falhas de cache e saída. A DeepSeek pode alterar essas tarifas; sua página Modelos e preços é a referência oficial para cobrança.

    Raciocínio e ferramentas

    As sessões de raciocínio do DeepSeek V4 exigem que as mensagens do assistente repassadas de um turno com raciocínio habilitado incluam reasoning_content nas solicitações seguintes. O plugin DeepSeek do OpenClaw preenche esse campo automaticamente, portanto o uso normal de ferramentas em múltiplos turnos funciona em deepseek/deepseek-v4-flash e deepseek/deepseek-v4-pro, mesmo quando o histórico veio de outro provedor compatível com a OpenAI (sem reasoning_content nativo) ou de uma mensagem simples do assistente. Não é necessário usar /new após trocar de provedor durante uma sessão.

    Quando o raciocínio está desabilitado (incluindo a seleção None na interface), o OpenClaw envia thinking: { type: "disabled" } e remove o reasoning_content repassado do histórico de saída, mantendo a sessão no fluxo sem raciocínio da DeepSeek.

    Use deepseek/deepseek-v4-flash como opção rápida padrão. Use deepseek/deepseek-v4-pro para obter o modelo mais avançado quando puder aceitar custo ou latência maiores.

    Testes em ambiente real

    Para executar somente as verificações diretas dos modelos DeepSeek V4 do conjunto moderno de testes de modelos em ambiente real:

    bash
    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

    Verifica se ambos os modelos V4 concluem a execução e se os turnos seguintes com raciocínio e ferramentas preservam a carga de repasse exigida pela DeepSeek.

    Exemplo de configuração

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

    Conteúdo relacionado

    Was this useful?
    On this page

    On this page