OpenClaw: integração com a API Claude

Documentação mantida por 1ZheAI. Fontes e correções.

Encontrou um erro? Contate o suporte com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

Use a funcionalidade de provedor personalizado do OpenClaw para conectar-se ao 1折AI. Primeiro, crie uma chave de API e confirme os modelos disponíveis atualmente; os IDs de modelo abaixo são exemplos — ajuste-os conforme as permissões da sua chave.

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.

Com base em provedor personalizado e exemplo de configuração, 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 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 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.

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 e as regras de cobrança. Para outros clientes, retorne ao diretório de integração de ferramentas; para escrever seu próprio programa, use o SDK e guia de desenvolvimento.