OpenClaw com DeepSeek: configuração, IDs de modelo e custos de API

O OpenClaw acessa o DeepSeek por meio de um plugin oficial do provedor instalado separadamente — openclaw plugins install @openclaw/deepseek-provider — com o ID de provedor deepseek, a chave DEEPSEEK_API_KEY, uma API compatível com OpenAI e a URL base https://api.deepseek.com sem /v1. Dois fatos determinam se sua primeira execução funcionará. O catálogo ativo do DeepSeek contém dois IDs, deepseek-flash e deepseek-v4-pro; os nomes deepseek-chat e deepseek-reasoner usados por tutoriais antigos foram descontinuados em 24 de julho de 2026. E a integração do OpenClaw define deepseek/deepseek-v4-pro como padrão, que é o único modelo cujo faturamento atual é contestado pelas próprias páginas do DeepSeek.

Uma distinção antes da configuração, porque os resultados de busca os misturam. Um OpenClaw diferente no GitHub se descreve como "uma reimplementação multiplataforma em C++ do jogo de plataforma original Captain Claw (1997)"; nada dele se aplica aqui. O agente é o projeto em openclaw.ai, documentado em docs.openclaw.ai — use esse host no link, pois documentation.openclaw.ai apenas redireciona para ele.

Instale e configure da forma documentada pelos dois projetos

# 1. Install the provider plugin — DeepSeek support is not bundled.
openclaw plugins install @openclaw/deepseek-provider

# 2. Interactive: prompts for the key, sets deepseek/deepseek-v4-pro as default.
openclaw onboard --auth-choice deepseek-api-key

# 2b. Or scripted, with the flags OpenClaw documents for a headless install.
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk

Com o plugin instalado, você não fornece uma URL base: o plugin publica seu próprio catálogo e seu próprio comportamento de compatibilidade. Uma configuração mínima contém a chave e o modelo, em JSON5.

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

O OpenClaw resolve a chave de um provedor a partir de quatro formatos de variáveis de ambiente, em uma ordem de prioridade documentada: OPENCLAW_LIVE_DEEPSEEK_KEY como uma substituição ativa única, com a maior prioridade; depois DEEPSEEK_API_KEYS como uma lista separada por vírgulas ou ponto e vírgulas; depois DEEPSEEK_API_KEY como a chave principal; e depois entradas numeradas DEEPSEEK_API_KEY_* (Interface de controle e chaves, verificado em 21 de setembro de 2026). Settings e depois Models na interface de controle adicionam ou substituem chaves sem editar o arquivo, e o material da chave permanece no armazenamento de autenticação. A armadilha em uma instalação de servidor é o escopo, não a grafia: a própria página do OpenClaw alerta que, se o Gateway for executado como um daemon pelo launchd ou systemd, a chave precisa estar visível para esse processo, por exemplo em ~/.openclaw/.env ou por meio de env.shellEnv.

Quais IDs de modelos DeepSeek estão realmente ativos

As linhas abaixo têm três status diferentes, não um só. A resposta de exemplo na referência de list-models do DeepSeek mostra exatamente dois IDs, deepseek-flash e deepseek-v4-pro, enquanto o catálogo incluído no OpenClaw ainda oferece quatro referências.

Mantenha separadas as duas declarações de descontinuação, porque parecem contraditórias, mas não são. O OpenClaw afirma que o DeepSeek retirou deepseek-chat e deepseek-reasoner e que "esses IDs de modelo não estão mais acessíveis". O DeepSeek afirma separadamente que "os nomes legados deepseek-v4-flash e deepseek-v4-flash-vision-exp ainda são aceitos, mas os modelos correspondentes foram retirados". Dois pares diferentes de nomes, dois resultados diferentes. A página Models & Pricing do DeepSeek atribui aos dois IDs ativos um contexto de 1M e uma saída máxima de 384K, e a tabela de catálogo do OpenClaw traz o mesmo par 1.000.000 / 384.000 em todas as quatro referências.

O ponto não resolvido. O anúncio de 10 de setembro de 2026 do DeepSeek afirma: "Estamos eliminando gradualmente o V4-Pro" e que "a partir de 04:00 UTC de 14 de setembro de 2026, todas as solicitações deepseek-v4-pro serão direcionadas para o V4.1-Flash às tarifas do V4.1-Flash". O registro de alterações da mesma versão afirma o oposto: "em resposta à demanda dos usuários, decidimos continuar oferecendo serviços de API para o DeepSeek V4 Pro após 14 de setembro de 2026, mantendo inalterado o método de faturamento". A página Models & Pricing ainda lista o V4 Pro com suas próprias tarifas mais altas e não traz nenhum aviso de descontinuação. Ambos foram consultados em 21 de setembro de 2026, uma semana após a data em questão. Esta página não dirá qual deles será cobrado — confirme na sua própria conta do DeepSeek antes de manter o padrão da integração e observe que o padrão é justamente o modelo contestado.

Quanto custam os tokens e por que o horário faz parte do preço

O DeepSeek publica tarifas de pico e fora de pico, sendo a tarifa fora de pico metade da tarifa de pico. A janela é estreita: "os horários de pico são 01:00–04:00 e 06:00–10:00 UTC, de segunda a sexta-feira, excluindo feriados públicos chineses. Todos os outros horários são fora de pico, incluindo fins de semana e todos os feriados públicos chineses". Sete horas dos dias úteis são de pico e todo o restante não é, portanto uma estimativa que presuma silenciosamente o pico superestima uma cobrança típica.

Lido na página Models & Pricing do DeepSeek em 21 de setembro de 2026. A linha do Flash é corroborada de forma independente pela página do provedor do OpenClaw, que informa "$0.30 por milhão de tokens de entrada, $1.20 por milhão de tokens de saída e $0.006 por milhão de tokens de entrada armazenados em cache". As linhas do V4 Pro dependem exclusivamente da página Models & Pricing e estão sujeitas à contradição acima, portanto trate-as como valores citados, não como algo definitivo.

A coluna de cache é a que altera a cobrança do agente, e sua proporção é incomum. Um cache hit em deepseek-flash custa $0.006 por milhão, contra $0.30 para um miss — aproximadamente um quinquagésimo da tarifa de miss, muito abaixo da proporção de um décimo comum em outros lugares; portanto, não transporte uma suposição de outro fornecedor. O guia de cache do DeepSeek afirma que o recurso "é ativado por padrão para todos os usuários, sem necessidade de modificar o código", que um hit exige um prefixo totalmente correspondente e que um cache não utilizado é limpo "geralmente em algumas horas a alguns dias". Hits e misses aparecem nos campos de uso prompt_cache_hit_tokens e prompt_cache_miss_tokens. O DeepSeek não publica um preço de gravação no cache, e sua tabela de preços não tem uma coluna de gravação no cache; isso é uma tarifa publicada ausente, não uma afirmação de que as gravações sejam gratuitas.

Uma sessão ilustrativa em deepseek-flash, com as tarifas publicadas pelo DeepSeek. Suponha uma execução do OpenClaw que envia 600.000 tokens de entrada, dos quais 450.000 encontram o cache de prefixo e 150.000 não encontram, e recebe 40.000 tokens de saída. No pico, isso equivale a $0.045 mais $0.0027 mais $0.048, ou $0.096; a mesma sessão fora de pico custa $0.048. A mesma execução sem nenhum cache hit custaria $0.228 no pico. Esses valores são operações aritméticas com tokens baseadas em suposições declaradas, não custos de tarefa medidos nem um limite de gastos — a proporção de cache hits da sua própria execução é a variável mais importante, e o valor exibido no aplicativo do OpenClaw não a resolverá, porque o OpenClaw afirma que seus custos locais são estimativas e aponta a página de preços do DeepSeek como autoridade para o faturamento.

Capacidade do modelo e suporte a ferramentas pelo cliente são duas perguntas diferentes

Esta é a parte que uma tabela de preços não consegue informar e é a razão prática para usar o plugin, em vez de uma entrada de provedor criada manualmente. As sessões de raciocínio do DeepSeek V4 exigem que mensagens de assistente reproduzidas de uma rodada com raciocínio ativado carreguem reasoning_content nas solicitações seguintes. O plugin DeepSeek do OpenClaw preenche esse campo automaticamente, portanto o uso de ferramentas em várias rodadas funciona "mesmo quando o histórico veio de outro provedor compatível com OpenAI (sem reasoning_content nativo) ou de uma mensagem simples de assistente", sem necessidade de /new após trocar de provedor no meio da sessão. Quando o raciocínio está desativado, inclusive na seleção None da interface, o OpenClaw envia thinking: { type: "disabled" } e remove reasoning_content reproduzidos do histórico de saída. O OpenClaw também mapeia /think xhigh e /think max para o valor máximo de reasoning_effort do DeepSeek.

Um provedor personalizado genérico openai-completions apontado para um endpoint compatível com DeepSeek não recebe nenhum desse preenchimento automático nem o formato de raciocínio do DeepSeek, a menos que você declare o bloco de compatibilidade por conta própria — a página ds4 do OpenClaw mostra o formato, incluindo thinkingFormat: "deepseek" e supportsReasoningEffort. Essa diferença é a explicação usual para uma rodada de ferramenta que funciona uma vez e depois falha na continuação.

Dois limites do lado do DeepSeek fazem parte da mesma decisão. A chamada de ferramentas no modo estrito usa uma URL base diferente, https://api.deepseek.com/beta, e exige "strict": true em cada função, além de "additionalProperties": false; não é para essa URL que o plugin aponta por padrão. E o guia de chamadas de ferramentas do DeepSeek afirma que "a API Chat Completion não oferece suporte à inserção de chamadas de ferramentas no meio da conversa, mas oferece suporte à inserção de mensagens system no meio da conversa; para inserir chamadas de ferramentas, use a API Anthropic ou a API Responses" — uma limitação do endpoint usado pelo plugin do OpenClaw, com duas alternativas documentadas, não uma limitação do modelo.

Quanto ao suporte do modelo, as duas fontes concordam. A coluna FEATURES da página Models & Pricing do DeepSeek marca Tool Calls, JSON Output, a API Responses e a API Anthropic como compatíveis tanto com deepseek-flash quanto com deepseek-v4-pro, e os separa quanto à visão — compatível com deepseek-flash, não compatível com deepseek-v4-pro. O OpenClaw afirma que o uso de ferramentas em várias rodadas funciona em todas as quatro referências. Nenhum dos lados documenta chamadas de ferramentas paralelas, portanto essa questão permanece genuinamente em aberto, sem resposta em qualquer direção.

Verifique em três etapas e depois examine as falhas que vale nomear

Verifique as camadas em ordem, porque cada uma falha de maneira diferente. Primeiro, o catálogo: openclaw models list --provider deepseek, ou openclaw models list --all --provider deepseek para inspecionar o catálogo estático do plugin sem um Gateway em execução; depois openclaw models set deepseek/deepseek-flash se quiser o modelo incontestado, em vez do padrão da integração. Segundo, um prompt curto sem streaming e depois um com streaming, que é onde um problema de autenticação ou de URL base aparece claramente. Terceiro — e somente terceiro — uma chamada de ferramenta seguida de uma segunda rodada na mesma sessão, que é a única etapa que exercita a reprodução de reasoning_content descrita acima.

A linha do 404 merece uma frase própria, porque é a única que a documentação não pode explicar por você. A tabela de códigos de erro da DeepSeek lista 400, 401, 402, 422, 429, 500 e 503 e não contém 404; portanto, um 404 aqui é evidência sobre o seu roteamento, não sobre a DeepSeek. O que a DeepSeek realmente retorna para um ID de modelo desconhecido não está documentado nem foi testado aqui. A referência de erros cobre os códigos de status equivalentes no endpoint da própria Kunavo.

Direta, gateway, local: qual rota vence

A Kunavo não oferece nenhum modelo DeepSeek. Seus modelos de texto pertencem às famílias Claude e OpenAI, portanto não há uma rota da Kunavo para um modelo DeepSeek, e esta página não está oferecendo uma. O que pode ser transferido é o mecanismo, algo que vale a pena conhecer se o motivo de você estar lendo uma página de configuração da DeepSeek é querer uma única chave entre famílias de modelos, em vez de especificamente a DeepSeek.

Para a linha do gateway, a configuração usa as mesmas duas alavancas. Declare models.providers.<id> com baseUrl, apiKey, api: "openai-completions" e um array models[] que liste pelo menos cada id, ou faça o onboarding no endpoint com --auth-choice custom-api-key, --custom-base-url e --custom-model-id. As referências de modelo são sempre provider/model, e a falha silenciosa consiste em criar um alias de modelo em agents.defaults.models sem registrá-lo em models.providers.<provider>.models[] — a referência de provedores personalizados do OpenClaw afirma que o alias "por si só não restringe substituições nem registra um novo modelo em tempo de execução". A URL base da Kunavo para essa rota é https://api.kunavo.com/v1, com exatamente um /v1 — o oposto da convenção sem sufixo da DeepSeek e a fonte mais provável de um 404 quando alguém copia o valor de uma página para o campo da outra.

Para dar uma noção da escala dessa alternativa, eis o mesmo formato de sessão presumido — 600.000 tokens de entrada e 40.000 tokens de saída, sem presumir cache — com preços baseados nas tarifas atuais do catálogo da Kunavo. Estes são modelos diferentes em um endpoint diferente, portanto esta é uma comparação de formato e não uma comparação de custo para a mesma tarefa com os números da DeepSeek acima; a tarifa listada mais barata e o menor custo para concluir uma tarefa são afirmações distintas, e somente a sua própria execução determina a segunda.

Aritmética ilustrativa de tokens com base nas premissas declaradas, não um custo de tarefa medido nem um limite máximo da cobrança. O valor do catálogo da Kunavo é um piso de cobrança, não um teto: quando o upstream informa seu custo, a cobrança é o maior entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável. As cobranças de cache e as ferramentas externas ficam fora deste exemplo. O recarregamento mínimo é $10 em crédito pré-pago — um mínimo de financiamento, não uma taxa de tarefa nem uma assinatura. Consulte detalhes de cobrança e cache.

Se essa rota adjacente é realmente o que você quer, comece pela visão geral das integrações para configurar a URL base e a chave, depois consulte o guia de início rápido para fazer a primeira chamada e crie uma conta na Kunavo quando estiver pronto para financiar uma chave. Trate isso como uma referência de configuração publicada, não como um resultado de compatibilidade: o OpenClaw não foi testado em tempo de execução contra o endpoint da Kunavo. Vai continuar no OpenClaw e escolher um modelo? Os preços do OpenClaw separam o software gratuito da cobrança por uso, a melhor API para o OpenClaw compara rotas por tarefa e a API compatível com OpenAI aborda as convenções de URL base sobre as quais esta página continua alertando.

Perguntas frequentes

Toda afirmação sobre OpenClaw e DeepSeek acima foi lida na documentação e nos registros dessas próprias plataformas em 21 de setembro de 2026, tendo como referência o OpenClaw v2026.9.5; a página do provedor, a página de preços, o registro de alterações, o anúncio de 10 de setembro, a referência de listagem de modelos, a tabela de códigos de erro, a página de limites de requisições e as regras de provedores personalizados foram buscados novamente diretamente para esta página. Nada foi instalado, integrado ou chamado: nenhuma execução do OpenClaw, nenhuma requisição a api.deepseek.com e nenhum teste em tempo de execução contra a Kunavo. As tarifas de tokens da Kunavo vêm do catálogo atual, e todos os valores em dólares são aritmética ilustrativa de tokens, não um custo medido.