Skip to main content

​
Vercel AI Gateway

The Vercel AI Gateway provides a unified API to access hundreds of models through a single endpoint.
  • Provider: vercel-ai-gateway
  • Auth: AI_GATEWAY_API_KEY
  • API: Anthropic Messages compatible

​
Quick start

  1. Set the API key (recommended: store it for the Gateway):
clawdia onboard --auth-choice ai-gateway-api-key
  1. Set a default model:
{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.5" }
    }
  }
}

​
Non-interactive example

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

​
Environment note

If the Gateway runs as a daemon (launchd/systemd), make sure AI_GATEWAY_API_KEY is available to that process (for example, in ~/.clawdia/.env or via env.shellEnv).