Pular para o conteúdo principal
O Vercel AI Gateway fornece uma API unificada para acessar centenas de modelos por meio de um único endpoint.
PropriedadeValor
Provedorvercel-ai-gateway
Pacote@openclaw/vercel-ai-gateway-provider
AutenticaçãoAI_GATEWAY_API_KEY
APIcompatível com Anthropic Messages
Catálogo de modelosDescoberto automaticamente via /v1/models
O OpenClaw descobre automaticamente o catálogo /v1/models do Gateway, então /models vercel-ai-gateway inclui refs de modelo atuais, como vercel-ai-gateway/openai/gpt-5.5 e vercel-ai-gateway/moonshotai/kimi-k2.6.

​
Primeiros passos

1

Install the plugin

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

Set the API key

Execute o onboarding e escolha a opção de autenticação do AI Gateway:
openclaw onboard --auth-choice ai-gateway-api-key
3

Set a default model

Adicione o modelo à sua configuração do OpenClaw:
{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}
4

Verify the model is available

openclaw models list --provider vercel-ai-gateway

​
Exemplo não interativo

Para configurações com scripts ou de CI, passe todos os valores na linha de comando: 
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 aceita refs de modelo abreviadas do Vercel Claude e as normaliza em tempo de execução:
Entrada abreviadaRef de modelo normalizada
vercel-ai-gateway/claude-opus-4.6vercel-ai-gateway/anthropic/claude-opus-4.6
vercel-ai-gateway/opus-4.6vercel-ai-gateway/anthropic/claude-opus-4-6
Você pode usar a forma abreviada ou a ref de modelo totalmente qualificada na sua configuração. O OpenClaw resolve a forma canônica automaticamente.

​
Configuração avançada

Se o Gateway do OpenClaw for executado como um daemon (launchd/systemd), garanta que AI_GATEWAY_API_KEY esteja disponível para esse processo.
Uma chave exportada somente em um shell interativo não ficará visível para um daemon launchd/systemd, a menos que esse ambiente seja importado explicitamente. Defina a chave em ~/.openclaw/.env ou via env.shellEnv para garantir que o processo do gateway possa lê-la.
O Vercel AI Gateway roteia solicitações para o provedor upstream com base no prefixo da ref de modelo. Por exemplo, vercel-ai-gateway/anthropic/claude-opus-4.6 roteia pelo Anthropic, enquanto vercel-ai-gateway/openai/gpt-5.5 roteia pelo OpenAI e vercel-ai-gateway/moonshotai/kimi-k2.6 roteia pelo MoonshotAI. Sua única AI_GATEWAY_API_KEY gerencia a autenticação para todos os provedores upstream.
As opções de /think seguem prefixos confiáveis de modelos upstream quando o OpenClaw conhece o contrato do provedor upstream. vercel-ai-gateway/anthropic/... usa o perfil de raciocínio do Claude, incluindo padrões adaptativos para modelos Claude 4.6. vercel-ai-gateway/openai/gpt-5.4, gpt-5.5 e refs no estilo Codex expõem /think xhigh assim como os provedores diretos OpenAI/OpenAI Codex. Outras refs com namespace mantêm os níveis normais de raciocínio, a menos que seus metadados de catálogo declarem mais.

​
Relacionados

Model selection

Escolha de provedores, refs de modelo e comportamento de failover.

Troubleshooting

Solução de problemas gerais e perguntas frequentes.