---
title: "OpenClaw: integração com a API Claude"
description: "Tutorial de configuração do endereço, chave e modelos da API Claude via retransmissão 1折AI no OpenClaw, incluindo escolha de protocolo, exemplos de configuração, etapas de verificação e erros comuns."
headingIds: {"Verificação da integração e resolução de problemas":"section-1","Custos e outras formas de integração":"section-2"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
Use a funcionalidade de provedor personalizado do OpenClaw para conectar-se ao 1折AI. Primeiro, [crie uma chave de API](/pt/docs/api-keys/) e confirme os [modelos disponíveis atualmente](/pt/docs/models/); os IDs de modelo abaixo são exemplos — ajuste-os conforme as permissões da sua chave.

<Note>
Data de verificação da configuração oficial: 2026-10-15. As configurações abaixo foram organizadas com base na documentação oficial; a verificação ponta a ponta neste site ainda não foi concluída — conclua primeiro uma breve pergunta-resposta e a verificação de chamada de ferramentas antes de usá-las em tarefas longas. Modelos OpenAI / GPT já estão disponíveis; a lista de modelos e preços está em [descrição dos modelos](/pt/docs/models/).
</Note>

Com base em [provedor personalizado](https://docs.openclaw.ai/gateway/config-tools/custom-providers) e [exemplo de configuração](https://docs.openclaw.ai/gateway/configuration-examples), combine em `~/.openclaw/openclaw.json`:

```json
{
  "agents": {
    "defaults": {
      "model": { "primary": "onezhe/claude-sonnet-4-6" },
      "models": { "onezhe/claude-sonnet-4-6": { "alias": "1折AI Claude" } }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "onezhe": {
        "baseUrl": "https://1zheai.com",
        "apiKey": "${ONEZHE_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
        ]
      }
    }
  }
}
```

Certifique-se de que o processo que executa o Gateway possa ler `ONEZHE_API_KEY`; variáveis de ambiente no terminal nem sempre são repassadas a serviços em segundo plano já existentes. A [documentação oficial do Synthetic](https://docs.openclaw.ai/providers/synthetic) deixa claro que o cliente Anthropic anexa automaticamente `/v1`, portanto, aqui não inclua `/v1` e não preencha o `/v1/messages` completo.

Ao usar Chat Completions, substitua em pares por `baseUrl: "https://1zheai.com/v1"` e `api: "openai-completions"`. Embora o nome contenha "completions", este adaptador corresponde a `/v1/chat/completions`; não selecione `openai-responses` por engano. Se já existir uma lista de modelos permitidos, mantenha as demais entradas e adicione o novo modelo. O exemplo não inventa custos ou parâmetros de contexto; se a versão instalada atual exigir metadados adicionais na validação, verifique primeiro as capacidades reais do modelo antes de adicioná-los.

## Verificação da integração e resolução de problemas

1. Salve e recarregue a configuração; confirme que o provedor selecionado atualmente é `onezhe` ou o modelo personalizado que você adicionou.
2. Envie uma pergunta curta e confirme que ela retorna; em seguida, tente uma pequena tarefa reversível e verifique separadamente a chamada de ferramentas e o diálogo em múltiplas rodadas.
3. Abra o [log de chamadas](/pt/docs/usage-logs/) e confira horário da requisição, modelo, status e uso. Uma única resposta de texto bem-sucedida não significa que todas as capacidades dos Agentes sejam compatíveis.
4. Em caso de 404, confira se o endereço e o protocolo deste artigo são compatíveis; em caso de 401, confira a origem da chave e se o processo leu as variáveis de ambiente; em caso de 429, consulte as informações de limitação de taxa antes de tentar novamente. Mais cenários em [códigos de erro e resolução de problemas](/pt/docs/troubleshooting/).

Guarde a chave apenas no ambiente local ou no armazenamento de credenciais da ferramenta; não a envie para repositórios de código, capturas de tela ou logs públicos. Serviços em segundo plano podem não herdar as variáveis de ambiente do terminal; modelos auxiliares, busca e outras ferramentas também podem ter configurações de provedor independentes e precisam ser verificadas separadamente.

## Custos e outras formas de integração

Consulte [preços em tempo real da API Claude](https://1zheai.com/en/pricing/) e as [regras de cobrança](/pt/docs/pricing-explained/). Para outros clientes, retorne ao [diretório de integração de ferramentas](/pt/docs/integrations/); para escrever seu próprio programa, use o [SDK e guia de desenvolvimento](/pt/docs/guides/).