OpenClaw integração com Claude: 2 métodos de configuração – Modo compatível com OpenAI vs Formato nativo Claude tutorial completo

Nota do autor: Um guia passo a passo para configurar os dois métodos de acesso no OpenClaw: o modo compatível com OpenAI e o formato nativo Claude, incluindo código de configuração JSON completo, lista de modelos aplicáveis e comparação das diferenças-chave.

No OpenClaw (Open WebUI), existem duas maneiras de conectar Modelos de Linguagem Grande: o modo compatível com OpenAI (openai-completions) e o formato nativo Claude (anthropic-messages). Muitos usuários não entendem a diferença entre eles, resultando no uso do formato errado para modelos Claude ou na perda de funcionalidades avançadas como o Prompt Caching que o formato nativo oferece.

Valor Principal: Após ler este artigo, você dominará os métodos completos de configuração para os dois modos de acesso no OpenClaw, saberá qual formato usar para cada modelo e poderá copiar e usar diretamente o código de configuração.

Comparação Principal dos Dois Métodos de Acesso no OpenClaw

Resumo em uma frase dos dois métodos de acesso no OpenClaw

Lembre-se de uma regra simples: Use anthropic-messages para a série de modelos Claude, e openai-completions para todos os outros modelos. A diferença mais óbvia entre os dois é a baseUrl — o modo compatível com OpenAI termina com /v1, o formato nativo Claude não.

Tutorial de Configuração do Modo Compatível com OpenAI no OpenClaw

Cenários de Uso do Modo Compatível com OpenAI

O modo compatível com OpenAI (openai-completions) é a forma mais universal de integração no OpenClaw, adequado para todos os Modelos de Linguagem Grande que não sejam Claude. A maioria dos serviços proxy de API utiliza esse formato padronizado da OpenAI.

Código de Configuração Completo do Modo Compatível com OpenAI

Abaixo está a configuração completa para integrar o GPT-5.4 através da APIYI:

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-sua-chave-API",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" }
        ]
      }
    }
  }
}

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-sua-chave-API",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      }
    }
  }
}

Pontos Principais da Configuração do Modo Compatível com OpenAI

🎯 Lembrete de Configuração: O /v1 no final do baseUrl não pode ser omitido, é o caminho padrão do protocolo compatível com OpenAI. Registre-se em APIYI apiyi.com para obter sua chave API e créditos gratuitos.

Tutorial de Configuração do Formato Nativo Claude no OpenClaw

Cenários de Uso do Formato Nativo Claude

O formato nativo Claude (anthropic-messages) é o método de integração exclusivo para a série de modelos Claude. Usar o formato nativo permite acessar funcionalidades avançadas únicas do Claude, como Prompt Caching, Extended Thinking e processamento de PDF.

Código de Configuração Completo do Formato Nativo Claude

Abaixo está a configuração completa para integrar modelos Claude através da APIYI:

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-sua-chave-API",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-sua-chave-API",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-haiku-4-5-20251001",
            "name": "Claude Haiku 4.5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

Pontos Principais da Configuração do Formato Nativo Claude

🎯 Diferença Crucial: O baseUrl do formato nativo Claude não inclui /v1. Este é o erro mais comum para iniciantes — se a integração do Claude apresentar erro, primeiro verifique se o URL não tem /v1 adicionado por engano no final.

Configuração para Uso Simultâneo de Dois Formatos no OpenClaw

Na prática, é bem provável que você precise usar tanto modelos gerais quanto o Claude. Nesse caso, é necessário configurar dois providers no OpenClaw:

Código de Configuração Combinada para Dois Providers

Basta escrever os dois formatos de provider no mesmo arquivo de configuração para poder alternar livremente entre os modelos no OpenClaw:

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-你的API密钥",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      },
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-你的API密钥",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

🎯 Observação Importante: Os dois providers podem usar a mesma chave API. A mesma chave da APIYI (apiyi.com) suporta simultaneamente o formato compatível com OpenAI e o formato nativo do Claude, sem a necessidade de solicitar múltiplas chaves.

Solução de Problemas Comuns dos Dois Formatos do OpenClaw

O ponto mais propenso a erros durante a configuração é a incompatibilidade entre o baseUrl e o tipo de API. Aqui estão os erros comuns e suas soluções:

🎯 Regra rápida para solução de problemas: Formato OpenAI inclui /v1, formato Claude não inclui /v1. Lembrar disso evita 80% dos erros de configuração. Se encontrar outros problemas, você pode visitar o centro de documentação da APIYI em apiyi.com para ver o guia completo de integração.

Perguntas Frequentes

Resumo

Os pontos principais das duas formas de conexão do OpenClaw:

1. Para modelos gerais, use openai-completions: Todos os modelos não-Claude, como GPT, Gemini, DeepSeek, GLM, Kimi, Grok, Minimax, etc. O baseUrl deve conter /v1.
2. Para a série Claude, use anthropic-messages: Modelos como claude-sonnet-4-6, claude-opus-4-6, claude-haiku, etc. O baseUrl NÃO deve conter /v1 e requer o header anthropic-version.
3. A melhor prática é ter os dois Provedores ativos: Configure o mesmo chave API em dois provedores no OpenClaw para alternar livremente entre todos os modelos.

Recomendamos obter sua chave API através do APIYI (apiyi.com). Uma única chave dá acesso a todos os principais modelos, como GPT, Claude, Gemini, DeepSeek, suportando tanto o formato compatível com OpenAI quanto o formato nativo do Claude.

📚 Referências

1. Central de Ajuda do APIYI: Tutorial completo de configuração do OpenClaw

   • Link: help.apiyi.com
   • Descrição: Contém documentação detalhada de conexão para cada site e a lista mais recente de modelos.

2. Documentação da API Anthropic: Especificação do formato de API nativa do Claude

   • Link: platform.claude.com/docs/en/api/messages
   • Descrição: Parâmetros completos e formato de resposta da Messages API.

3. Documentação de Compatibilidade do SDK OpenAI: Quais parâmetros são ignorados no Claude

   • Link: platform.claude.com/docs/en/api/openai-sdk
   • Descrição: Lista completa de parâmetros suportados e não suportados.

4. Documentação do Open WebUI: Guia de configuração de múltiplos Provedores no OpenClaw

   • Link: docs.openwebui.com
   • Descrição: Configuração de Provedores, gerenciamento de modelos e configuração de Agentes.

Autor: Equipe Técnica do APIYI
Discussão Técnica: Bem-vindo(a) para discutir na seção de comentários. Mais materiais podem ser encontrados no centro de documentação do APIYI: docs.apiyi.com