Vercel AI Gateway Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: Vercel AI gateway
개요
이 페이지는 OpenClaw Vercel AI Gateway provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: Vercel AI Gateway setup (auth + model selection)
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
빠른 참조
| 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 |
공식 문서 기반 상세
아래는 공식 providers/vercel-ai-gateway 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
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/modelscatalog, so both the/models vercel-ai-gatewaychat command andopenclaw models list --provider vercel-ai-gatewayinclude current model refs such asvercel-ai-gateway/openai/gpt-5.5andvercel-ai-gateway/moonshotai/kimi-k2.6.
시작하기
Install the plugin
```bash
openclaw plugins install @openclaw/vercel-ai-gateway-provider
```
Set the API key
```bash
openclaw onboard --auth-choice ai-gateway-api-key
```
Set a default model
```json5
{
agents: {
defaults: {
model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
},
},
}
```
Verify the model is available
```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 |
Use either form in your configuration; OpenClaw resolves the canonical
anthropic/...ref automatically.
고급 설정
Environment variable for daemon processes
If the OpenClaw Gateway runs as a daemon (launchd/systemd), make sure
`AI_GATEWAY_API_KEY` is available to that process.
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/.envor viaenv.shellEnvto ensure the gateway process can read it.
Provider routing
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.
Thinking levels
`/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.
검증 체크리스트
-
openclaw models list --provider vercel-ai-gateway로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토