OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Gateway de IA da Vercel

O Vercel AI Gateway fornece uma API unificada para acessar centenas de modelos por meio de um único endpoint.

Propriedade Valor
Provedor vercel-ai-gateway
Pacote @openclaw/vercel-ai-gateway-provider
Autenticação AI_GATEWAY_API_KEY
API Compatível com Anthropic Messages
URL base https://ai-gateway.vercel.sh
Catálogo de modelos Descoberto automaticamente via /v1/models

Primeiros passos

  • Instalar o plugin

    bash
    openclaw plugins install @openclaw/vercel-ai-gateway-provider

  • Definir a chave da API

    bash
    openclaw onboard --auth-choice ai-gateway-api-key

  • Definir um modelo padrão

    json5
    {  agents: {    defaults: {      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },    },  },}

  • Verificar se o modelo está disponível

    bash
    openclaw models list --provider vercel-ai-gateway

    • Exemplo não interativo

    bash
    openclaw onboard --non-interactive \  --mode local \  --auth-choice ai-gateway-api-key \  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

    Forma abreviada do ID do modelo

    O OpenClaw normaliza referências abreviadas de modelos Claude em tempo de execução:

    Entrada abreviada Referência normalizada do modelo
    vercel-ai-gateway/claude-opus-4.6 vercel-ai-gateway/anthropic/claude-opus-4.6
    vercel-ai-gateway/opus-4.6 vercel-ai-gateway/anthropic/claude-opus-4-6

    Configuração avançada

    Variável de ambiente para processos daemon

    Se o Gateway do OpenClaw for executado como daemon (launchd/systemd), certifique-se de que AI_GATEWAY_API_KEY esteja disponível para esse processo.

    Roteamento de provedores

    O Vercel AI Gateway encaminha cada solicitação ao provedor upstream indicado no prefixo da referência do modelo. Por exemplo, vercel-ai-gateway/anthropic/claude-opus-4.6 é encaminhado pela Anthropic, vercel-ai-gateway/openai/gpt-5.5 é encaminhado pela OpenAI e vercel-ai-gateway/moonshotai/kimi-k2.6 é encaminhado pela MoonshotAI. Uma única AI_GATEWAY_API_KEY autentica todos os provedores upstream.

    Níveis de raciocínio

    As opções de /think seguem o prefixo do modelo upstream quando o OpenClaw o reconhece. vercel-ai-gateway/anthropic/... usa o perfil de raciocínio do Claude, incluindo o padrão adaptativo para modelos Claude 4.6. Referências confiáveis vercel-ai-gateway/openai/... (gpt-5.2 e posteriores, além de variantes do Codex até gpt-5.1-codex) disponibilizam /think xhigh. Outras referências com namespace mantêm os níveis de raciocínio padrão, a menos que os metadados do catálogo indiquem níveis adicionais.

    Relacionados

    Seleção de modelos

    Como escolher provedores, referências de modelos e o comportamento de failover.
    Solução de problemas

    Solução geral de problemas e perguntas frequentes.
    Was this useful?
    On this page

    On this page