---
read_when:
- Você quer usar o DeepSeek com o OpenClaw
- Você precisa da variável de ambiente da chave de API ou da opção de autenticação da CLI
summary: Configuração do DeepSeek (autenticação + seleção de modelo)
title: DeepSeek
x-i18n:
generated_at: "2026-07-12T00:17:06Z"
model: gpt-5.6
postprocess_version: locale-links-v1
provider: openai
source_hash: 77e074756d593205d7d05f499da93b9bd3c63acdce7092b42fb5562023577925
source_path: providers/deepseek.md
workflow: 16
---
[DeepSeek](https://www.deepseek.com) 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-provider
openclaw gateway restart
```
## Primeiros passos
Crie uma chave de API em [platform.deepseek.com](https://platform.deepseek.com/api_keys).
```bash
openclaw onboard --auth-choice deepseek-api-key
```
Solicita sua chave de API e define `deepseek/deepseek-v4-flash` como o modelo padrão.
```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
```
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
```
Se o Gateway for executado como um daemon (launchd/systemd), certifique-se de que `DEEPSEEK_API_KEY`
esteja disponível para esse processo (por exemplo, em `~/.openclaw/.env` ou por meio de
`env.shellEnv`).
## 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 |
A DeepSeek descontinuará `deepseek-chat` e `deepseek-reasoner` em 24 de julho de 2026,
às 15h59 UTC. Atualmente, eles são encaminhados ao DeepSeek V4 Flash nos modos sem
raciocínio e com raciocínio, respectivamente. Migre as referências de modelo configuradas para
`deepseek/deepseek-v4-flash` ou `deepseek/deepseek-v4-pro` antes do prazo.
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](https://api-docs.deepseek.com/quick_start/pricing/) é
a referência oficial para cobrança.
Os modelos V4 são compatíveis com o controle `thinking` da DeepSeek. O OpenClaw também repassa
o `reasoning_content` da DeepSeek nos turnos seguintes, permitindo que sessões de raciocínio com chamadas
de ferramentas continuem.
Use `/think xhigh` ou `/think max` com modelos DeepSeek V4 para solicitar o
`reasoning_effort` máximo da DeepSeek; ambos são mapeados para `"max"`.
## 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
Como escolher provedores, referências de modelos e o comportamento de failover.
Referência completa de configuração para agentes, modelos e provedores.