mirror of
https://github.com/openclaw/openclaw.git
synced 2026-07-16 23:31:38 +00:00
Source-grounded rewrite of 529 published docs pages with per-unit information-loss verification: 1,713 factual corrections cited to src/**, generated surfaces regenerated, frontmatter titles preserved for i18n, release notes pages untouched. All docs gates green. Closes #100141
4.2 KiB
4.2 KiB
summary, title, read_when
| summary | title | read_when | ||
|---|---|---|---|---|
| Vercel AI Gateway setup (auth + model selection) | Vercel AI gateway |
|
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 |
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 \
--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 |
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.