콘텐츠로 이동
이 페이지는 더 이상 업데이트되지 않습니다. 최신 내용은 OpenClaw 공식 문서에서 확인하세요 →

Kilo Gateway 시작하기

여러 AI 모델을 프로젝트에 연동하다 보면 API Key를 관리하고 엔드포인트를 일일이 변경하는 일이 꽤나 번거로워요. 새로운 모델을 테스트하고 싶을 때마다 코드를 대대적으로 수정해야 하는 상황은 개발 흐름을 방해하곤 하죠.

Kilo Gateway는 이런 문제를 해결하기 위해 여러 모델을 하나의 엔드포인트와 API Key로 연결하는 unified API를 제공해요. OpenAI와 호환되기 때문에 기존 OpenAI SDK에서 base URL만 바꾸면 바로 사용할 수 있어 편리해요.

시작하기 전에 다음 항목이 필요해요.

5분 안에 Kilo Gateway 설정을 마칠 수 있어요. 아래 단계를 따라해 보세요.

  1. app.kilo.ai에 접속하세요.
  2. 로그인하거나 새 계정을 만드세요.
  3. API Keys 메뉴로 이동해 새 Key를 생성하세요.

터미널에서 다음 명령어를 실행해 설정을 완료하세요.

Terminal window
openclaw onboard --kilocode-api-key <key>

또는 환경 변수를 직접 설정할 수도 있어요.

Terminal window
export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret

프로젝트 설정에 아래 내용을 추가하세요.

{
env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret
agents: {
defaults: {
model: { primary: "kilocode/kilo/auto" },
},
},
}

기본 모델인 kilocode/kilo/auto는 작업의 성격에 따라 최적의 모델을 자동으로 선택해 주는 스마트 라우팅 모델이에요.

  • Planning, debugging, orchestration 작업은 Claude Opus로 연결돼요.
  • Code writing, exploration 작업은 Claude Sonnet으로 연결돼요.

OpenClaw는 실행 시 Kilo Gateway에서 사용 가능한 모델을 동적으로 찾아내요. 내 계정에서 쓸 수 있는 전체 목록을 보려면 /models kilocode를 입력하세요.

Gateway에서 제공하는 모든 모델은 kilocode/ 접두사를 붙여서 사용할 수 있어요.

kilocode/kilo/auto (기본값 - 스마트 라우팅)
kilocode/anthropic/claude-sonnet-4
kilocode/openai/gpt-5.2
kilocode/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에게 물어보세요.

OpenClaw

OpenClaw Expert

아직 막혀 있나요?

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.