OpenClawDocs
Nesta página

Nesta página

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?