bot/docs/providers/vercel-ai-gateway.md

title, summary, read_when

title	summary	read_when
Vercel AI Gateway	Vercel AI Gateway setup (auth + model selection)	You want to use Vercel AI Gateway with Hanzo Bot You need the API key env var or CLI auth choice

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
• Hanzo Bot auto-discovers the Gateway /v1/models catalog, so /models vercel-ai-gateway includes current model refs such as vercel-ai-gateway/openai/gpt-5.4.

Quick start

1. Set the API key (recommended: store it for the Gateway):

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

2. Set a default model:

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

Non-interactive example

openclaw 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 ~/.hanzo/bot/.env or via env.shellEnv).

Model ID shorthand

Hanzo Bot accepts Vercel Claude shorthand model refs and normalizes them at runtime:

• 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