Providers
Vercel AI 게이트웨이
Vercel AI Gateway는 단일 엔드포인트를 통해 수백 개의 모델에 접근할 수 있는 통합 API를 제공합니다.
| 속성 | 값 |
|---|---|
| Provider | vercel-ai-gateway |
| Package | @openclaw/vercel-ai-gateway-provider |
| Auth | AI_GATEWAY_API_KEY |
| API | Anthropic Messages 호환 |
| 모델 카탈로그 | /v1/models를 통해 자동 검색됨 |
시작하기
Plugin 설치
openclaw plugins install @openclaw/vercel-ai-gateway-providerAPI 키 설정
온보딩을 실행하고 AI Gateway 인증 옵션을 선택합니다.
openclaw onboard --auth-choice ai-gateway-api-key기본 모델 설정
OpenClaw 구성에 모델을 추가합니다.
{ agents: { defaults: { model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" }, }, },}모델 사용 가능 여부 확인
openclaw models list --provider vercel-ai-gateway비대화형 예제
스크립트 또는 CI 설정에서는 모든 값을 명령줄로 전달합니다.
openclaw onboard --non-interactive \ --mode local \ --auth-choice ai-gateway-api-key \ --ai-gateway-api-key "$AI_GATEWAY_API_KEY"모델 ID 축약형
OpenClaw는 Vercel Claude 축약형 모델 참조를 허용하고 런타임에 정규화합니다.
| 축약형 입력 | 정규화된 모델 참조 |
|---|---|
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 |
고급 구성
데몬 프로세스용 환경 변수
OpenClaw Gateway가 데몬(launchd/systemd)으로 실행되는 경우
AI_GATEWAY_API_KEY를 해당 프로세스에서 사용할 수 있는지 확인하세요.
Provider 라우팅
Vercel AI Gateway는 모델 참조 접두사를 기준으로 업스트림 Provider에 요청을 라우팅합니다.
예를 들어 vercel-ai-gateway/anthropic/claude-opus-4.6은 Anthropic을 통해 라우팅되고,
vercel-ai-gateway/openai/gpt-5.5는 OpenAI를 통해 라우팅되며,
vercel-ai-gateway/moonshotai/kimi-k2.6는 MoonshotAI를 통해 라우팅됩니다.
단일 AI_GATEWAY_API_KEY가 모든 업스트림 Provider의 인증을 처리합니다.
사고 수준
/think 옵션은 OpenClaw가 업스트림 Provider 계약을 알고 있을 때 신뢰할 수 있는 업스트림 모델 접두사를 따릅니다.
vercel-ai-gateway/anthropic/...은 Claude 사고 프로필을 사용하며, Claude 4.6 모델의 적응형 기본값도 포함합니다.
vercel-ai-gateway/openai/gpt-5.4, gpt-5.5 및 Codex 스타일 참조는 직접 OpenAI/OpenAI Codex Provider와 마찬가지로
/think xhigh를 노출합니다. 다른 네임스페이스 참조는 카탈로그 메타데이터가 더 많은 항목을 선언하지 않는 한
일반 추론 수준을 유지합니다.
