Skip to main content
Vercel AI Gateway는 단일 엔드포인트를 통해 수백 개의 모델에 접근할 수 있는 통합 API를 제공합니다.
OpenClaw은 Gateway의 /v1/models 카탈로그를 자동으로 검색하므로 /models vercel-ai-gateway 채팅 명령과 openclaw models list --provider vercel-ai-gateway 모두 vercel-ai-gateway/openai/gpt-5.5 및 vercel-ai-gateway/moonshotai/kimi-k2.6와 같은 현재 모델 참조를 포함합니다.

​
시작하기

1

Plugin 설치

2

API 키 설정

3

기본 모델 설정

4

모델 사용 가능 여부 확인

​
비대화형 예시

​
모델 ID 축약형

OpenClaw은 런타임에 Claude 축약형 모델 참조를 정규화합니다.
구성에서 어느 형식이든 사용할 수 있으며, OpenClaw이 표준 anthropic/... 참조를 자동으로 확인합니다.

​
고급 구성

OpenClaw Gateway가 데몬(launchd/systemd)으로 실행되는 경우 해당 프로세스에서 AI_GATEWAY_API_KEY를 사용할 수 있는지 확인하세요.
대화형 셸에서만 내보낸 키는 해당 환경을 명시적으로 가져오지 않는 한 launchd/systemd 데몬에서 사용할 수 없습니다. Gateway 프로세스가 키를 읽을 수 있도록 ~/.openclaw/.env 또는 env.shellEnv를 통해 키를 설정하세요.
Vercel AI Gateway는 모델 참조 접두사에 지정된 업스트림 제공자로 각 요청을 라우팅합니다. 예를 들어 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로 모든 업스트림 제공자를 인증합니다.
OpenClaw이 업스트림 모델 접두사를 인식하면 /think 옵션은 해당 접두사를 따릅니다. vercel-ai-gateway/anthropic/...은 Claude 4.6 모델의 적응형 기본값을 포함한 Claude 사고 프로필을 사용합니다. 신뢰할 수 있는 vercel-ai-gateway/openai/... 참조(gpt-5.2 이상 및 gpt-5.1-codex까지의 Codex 변형)는 /think xhigh를 제공합니다. 그 밖의 네임스페이스가 지정된 참조는 카탈로그 메타데이터에 더 높은 수준이 선언되어 있지 않은 한 표준 추론 수준을 유지합니다.

​
관련 항목

모델 선택

제공자, 모델 참조 및 장애 조치 동작을 선택하는 방법입니다.

문제 해결

일반적인 문제 해결 방법과 자주 묻는 질문입니다.