Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

O Vercel AI Gateway fornece uma API unificada para acessar centenas de modelos por meio de um único endpoint.
PropriedadeValor
Provedorvercel-ai-gateway
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, portanto /models vercel-ai-gateway inclui refs de modelos atuais, como vercel-ai-gateway/openai/gpt-5.5 e vercel-ai-gateway/moonshotai/kimi-k2.6.

​
Primeiros passos

1

Defina a chave de API

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

Defina um modelo padrão

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

Verifique se o modelo está disponível

openclaw models list --provider vercel-ai-gateway

​
Exemplo não interativo

Para configurações com scripts ou em 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"

​
Abreviação de ID de modelo

O OpenClaw aceita refs abreviadas de modelos Claude da Vercel 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 abreviação 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 OpenClaw Gateway for executado como daemon (launchd/systemd), garanta que AI_GATEWAY_API_KEY esteja disponível para esse processo.
Uma chave definida apenas em ~/.profile 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 consiga 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 via Anthropic, enquanto vercel-ai-gateway/openai/gpt-5.5 roteia via OpenAI e vercel-ai-gateway/moonshotai/kimi-k2.6 roteia via MoonshotAI. Sua única AI_GATEWAY_API_KEY lida com a autenticação para todos os provedores upstream.
As opções de /think seguem prefixos de modelos upstream confiáveis quando o OpenClaw conhece o contrato do provedor upstream. vercel-ai-gateway/anthropic/... usa o perfil de pensamento 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 os metadados do catálogo declarem mais.

​
Relacionado

Seleção de modelos

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

Solução de problemas

Solução de problemas geral e FAQ.