> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openclaw.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# Vercel AI 게이트웨이

# Vercel AI 게이트웨이

[Vercel AI 게이트웨이](https://vercel.com/ai-gateway)는 단일 엔드포인트를 통해 수백 개의 모델에 접근할 수 있는 통합 API를 제공합니다.

* 프로바이더: `vercel-ai-gateway`
* 인증: `AI_GATEWAY_API_KEY`
* API: Anthropic Messages 호환
* OpenClaw는 Gateway의 `/v1/models` 카탈로그를 자동 탐색하므로 `/models vercel-ai-gateway`에는 `vercel-ai-gateway/openai/gpt-5.4` 같은 최신 모델 ref가 포함됩니다.

## 빠른 시작

1. API 키를 설정합니다 (권장: 이를 게이트웨이에 저장하세요):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice ai-gateway-api-key
```

2. 기본 모델을 설정합니다:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}
```

## 비대화형 예제

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"
```

## 환경 주의사항

게이트웨이가 데몬(launchd/systemd)으로 실행되는 경우, `AI_GATEWAY_API_KEY`가 해당 프로세스에 제공되는지 확인하세요 (예: `~/.openclaw/.env` 또는 `env.shellEnv`를 통해).

## 모델 ID 축약형

OpenClaw는 Vercel Claude 축약형 모델 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`