stack/docs/providers/vercel-ai-gateway.md at 3b7fd19d087226b1887bf017fc10ef16b044f6aa

Files

T

jason.woltje 193479b52d docs: concept annexation, provider/reference docs, ACT-1 groundwork

Mosaic concepts pages now own the adapted content; source/license
metadata under docs/reference/concepts. Adds ACT-1 agent-context
planning capture, pinned concept test package + preparation utility,
foundation observation notes (durability, evidence, federation,
onboarding, workflow), and the #1495 consolidation assessment.
TOOLS.md updated for the host-dev launcher.

2026-09-07 14:07:05 -05:00

4.2 KiB

Raw Blame History

summary, title, read_when

summary

title

read_when

Vercel AI Gateway setup (auth + model selection)

Vercel AI gateway

You want to use Vercel AI Gateway with OpenClaw

You need the API key env var or CLI auth choice

The Vercel AI Gateway provides a unified API to access hundreds of models through a single endpoint.

Property	Value
Provider	`vercel-ai-gateway`
Package	`@openclaw/vercel-ai-gateway-provider`
Auth	`AI_GATEWAY_API_KEY`
API	Anthropic Messages compatible
Base URL	`https://ai-gateway.vercel.sh`
Model catalog	Auto-discovered via `/v1/models`

OpenClaw auto-discovers the Gateway `/v1/models` catalog, so both the `/models vercel-ai-gateway` chat command and `openclaw models list --provider vercel-ai-gateway` include current model refs such as `vercel-ai-gateway/openai/gpt-5.5` and `vercel-ai-gateway/moonshotai/kimi-k2.6`.

Getting started

```bash openclaw plugins install @openclaw/vercel-ai-gateway-provider ``` ```bash openclaw onboard --auth-choice ai-gateway-api-key ``` ```json5 { agents: { defaults: { model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" }, }, }, } ``` ```bash openclaw models list --provider vercel-ai-gateway ```

Non-interactive example

openclaw onboard --non-interactive --accept-risk --skip-health \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

Model ID shorthand

OpenClaw normalizes Claude shorthand model refs at runtime:

Shorthand input	Normalized model ref
`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`

Use either form in your configuration; OpenClaw resolves the canonical `anthropic/...` ref automatically.

Advanced configuration

If the OpenClaw Gateway runs as a daemon (launchd/systemd), make sure `AI_GATEWAY_API_KEY` is available to that process.

<Warning>
A key exported only in an interactive shell will not be visible to a
launchd/systemd daemon unless that environment is explicitly imported. Set
the key in `~/.openclaw/.env` or via `env.shellEnv` to ensure the gateway
process can read it.
</Warning>

Vercel AI Gateway routes each request to the upstream provider named in the model ref prefix. For example, `vercel-ai-gateway/anthropic/claude-opus-4.6` routes through Anthropic, `vercel-ai-gateway/openai/gpt-5.5` routes through OpenAI, and `vercel-ai-gateway/moonshotai/kimi-k2.6` routes through MoonshotAI. One `AI_GATEWAY_API_KEY` authenticates all upstream providers. `/think` options follow the upstream model prefix when OpenClaw recognizes it. `vercel-ai-gateway/anthropic/...` uses the Claude thinking profile, including the adaptive default for Claude 4.6 models. Trusted `vercel-ai-gateway/openai/...` refs (`gpt-5.2` and newer, plus Codex variants down to `gpt-5.1-codex`) expose `/think xhigh`. Other namespaced refs keep the standard reasoning levels unless their catalog metadata declares more. Choosing providers, model refs, and failover behavior. General troubleshooting and FAQ.

4.2 KiB Raw Blame History

Getting started

Non-interactive example

Model ID shorthand

Advanced configuration

Related

4.2 KiB

Raw Blame History