Vercel AI Gateway로 여러 모델을 한 번에 관리하기

수많은 AI 모델을 오가며 API 키를 관리하는 건 정말 피곤한 일이죠. 저도 예전에는 새로운 모델을 테스트할 때마다 엔드포인트를 새로 따고 설정 파일을 뒤지느라 시간을 다 버렸거든요. Vercel AI Gateway를 사용하면 이런 번거로움 없이 단 하나의 API로 수백 개의 모델을 깔끔하게 관리할 수 있어요.

필요한 것

시작하기 전에 다음 사항들을 준비해 주세요.

• Vercel 계정 및 생성된 AI Gateway
• AI_GATEWAY_API_KEY
• 설치된 OpenClaw
• Anthropic 또는 OpenAI 등 사용하려는 모델의 프로바이더 계정

빠른 시작

5분 안에 설정을 끝내고 바로 모델을 불러와 볼게요.

1. 우선 API 키를 설정합니다. Gateway 전용으로 키를 저장하는 방식을 추천해요.

openclaw onboard --auth-choice ai-gateway-api-key

2. 그 다음, 기본으로 사용할 모델을 설정 파일에 추가하세요.

{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}

만약 대화형 인터페이스 없이 한 번에 설정을 끝내고 싶다면 아래 명령어를 사용하면 됩니다.

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

문제 해결

설정 중에 문제가 생겼나요? 가장 자주 발생하는 상황 두 가지를 정리했습니다.

• 환경 변수 인식 문제: Gateway를 daemon(launchd 또는 systemd)으로 실행하고 있다면, 프로세스가 AI_GATEWAY_API_KEY를 읽지 못할 수 있어요. 이럴 때는 ~/.openclaw/.env 파일에 키를 직접 적어주거나 env.shellEnv를 통해 경로를 명시해 주세요.
• 인증 에러: API 키가 정확한데도 에러가 난다면, Vercel 대시보드에서 해당 Gateway가 활성화 상태인지, 그리고 선택한 모델의 프로바이더 설정이 올바른지 다시 확인해 보세요.

더 궁금한 점이 있다면 AI Setup Assistant에게 물어보세요!

다음 단계

• 모델 구성 가이드
• 에이전트 커스터마이징