Kilo Gateway 시작하기
여러 AI 모델을 프로젝트에 연동하다 보면 API Key를 관리하고 엔드포인트를 일일이 변경하는 일이 꽤나 번거로워요. 새로운 모델을 테스트하고 싶을 때마다 코드를 대대적으로 수정해야 하는 상황은 개발 흐름을 방해하곤 하죠.
Kilo Gateway는 이런 문제를 해결하기 위해 여러 모델을 하나의 엔드포인트와 API Key로 연결하는 unified API를 제공해요. OpenAI와 호환되기 때문에 기존 OpenAI SDK에서 base URL만 바꾸면 바로 사용할 수 있어 편리해요.
필요한 것
섹션 제목: “필요한 것”시작하기 전에 다음 항목이 필요해요.
- app.kilo.ai 계정
- Kilo Gateway API Key
빠른 시작
섹션 제목: “빠른 시작”5분 안에 Kilo Gateway 설정을 마칠 수 있어요. 아래 단계를 따라해 보세요.
1. API Key 발급받기
섹션 제목: “1. API Key 발급받기”- app.kilo.ai에 접속하세요.
- 로그인하거나 새 계정을 만드세요.
- API Keys 메뉴로 이동해 새 Key를 생성하세요.
2. CLI 설정
섹션 제목: “2. CLI 설정”터미널에서 다음 명령어를 실행해 설정을 완료하세요.
openclaw onboard --kilocode-api-key <key>또는 환경 변수를 직접 설정할 수도 있어요.
export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret3. Config 적용
섹션 제목: “3. Config 적용”프로젝트 설정에 아래 내용을 추가하세요.
{ env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret agents: { defaults: { model: { primary: "kilocode/kilo/auto" }, }, },}Default model
섹션 제목: “Default model”기본 모델인 kilocode/kilo/auto는 작업의 성격에 따라 최적의 모델을 자동으로 선택해 주는 스마트 라우팅 모델이에요.
- Planning, debugging, orchestration 작업은 Claude Opus로 연결돼요.
- Code writing, exploration 작업은 Claude Sonnet으로 연결돼요.
Available models
섹션 제목: “Available models”OpenClaw는 실행 시 Kilo Gateway에서 사용 가능한 모델을 동적으로 찾아내요. 내 계정에서 쓸 수 있는 전체 목록을 보려면 /models kilocode를 입력하세요.
Gateway에서 제공하는 모든 모델은 kilocode/ 접두사를 붙여서 사용할 수 있어요.
kilocode/kilo/auto (기본값 - 스마트 라우팅)kilocode/anthropic/claude-sonnet-4kilocode/openai/gpt-5.2kilocode/google/gemini-3-pro-preview...기타 다양한 모델문제 해결
섹션 제목: “문제 해결”문제가 발생하면 다음 사항을 확인해 보세요.
- 모델 호출 오류: 모델 ID를 입력할 때
kilocode/anthropic/claude-sonnet-4처럼 반드시kilocode/접두사를 포함했는지 확인하세요. - 연결 확인: Kilo Gateway의 base URL은
https://api.kilo.ai/api/gateway/예요. SDK 설정에서 이 주소가 정확한지 확인해 보세요.
더 자세한 도움이 필요하다면 AI Setup Assistant에게 물어보세요.
다음 단계
섹션 제목: “다음 단계”- /concepts/model-providers 에서 더 많은 모델과 제공자 옵션을 확인해 보세요.
OpenClaw Expert
아직 막혀 있나요?
이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.