Skip to main content
Kilo Gateway는 단일 OpenAI 호환 엔드포인트와 API 키를 통해 여러 모델로 요청을 라우팅합니다.

​
Plugin 설치

​
설정

1

계정 만들기

app.kilo.ai로 이동하여 로그인하거나 계정을 만든 다음 API 키를 생성합니다.
2

온보딩 실행

또는 환경 변수를 직접 설정합니다.
3

모델 사용 가능 여부 확인

​
기본 모델 및 카탈로그

기본 모델은 제공자가 관리하는 스마트 라우팅 모델인 kilocode/kilo/auto입니다. OpenClaw는 이 모델의 작업별 업스트림 모델 매핑을 공개하지 않으며, kilo/auto 내부의 라우팅은 Kilo Gateway가 관리합니다. 시작 시 OpenClaw는 GET https://api.kilo.ai/api/gateway/models를 조회하고 검색된 모델을 정적 대체 카탈로그보다 우선하여 병합합니다. 정적 대체 카탈로그에는 kilocode/kilo/auto (Kilo Auto, input: ["text", "image"], reasoning: true, contextWindow: 1000000, maxTokens: 128000)만 포함됩니다. Gateway의 모든 모델은 kilocode/<upstream-id> 형식으로 지정할 수 있습니다(예: kilocode/anthropic/claude-sonnet-4, kilocode/openai/gpt-5.5). 검색된 전체 목록을 확인하려면 /models kilocode 또는 openclaw models list --provider kilocode를 실행합니다.

​
구성 예시

​
동작 참고 사항

Kilo Gateway는 OpenRouter와 호환되므로 네이티브 OpenAI 요청 형식 대신 프록시 방식의 OpenAI 호환 요청 경로를 사용합니다(store 없음, OpenAI 추론 노력 수준 페이로드 없음).
  • Gemini 기반 Kilo 참조는 프록시 Gemini 경로를 계속 사용합니다. OpenClaw는 이 경로에서 Gemini 사고 서명을 정리하지만 네이티브 Gemini 재실행 검증 또는 부트스트랩 재작성은 활성화하지 않습니다.
  • 요청은 API 키로 생성한 Bearer 토큰을 사용합니다.
Kilo 스트림 래퍼는 X-KILOCODE-FEATURE 요청 헤더를 추가하고(기본값 openclaw, KILOCODE_FEATURE 환경 변수로 재정의 가능), 이를 지원하는 모델의 추론 노력 수준 페이로드를 정규화합니다.
kilocode/kilo/auto 및 x-ai/* 참조에는 추론 노력 수준이 삽입되지 않습니다. 추론 지원이 필요한 경우 kilocode/anthropic/claude-sonnet-4와 같은 구체적인 모델 참조를 사용하세요.
  • 시작 시 모델 검색에 실패하면 OpenClaw는 kilocode/kilo/auto가 포함된 정적 카탈로그를 대신 사용합니다.
  • API 키가 유효하며 Kilo 계정에서 원하는 모델이 활성화되어 있는지 확인하세요.
  • Gateway가 데몬으로 실행되는 경우 해당 프로세스에서 KILOCODE_API_KEY를 사용할 수 있는지 확인하세요(예: ~/.openclaw/.env 또는 env.shellEnv 사용).

​
관련 문서

모델 선택

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

구성 참조

전체 OpenClaw 구성 참조입니다.

Kilo Gateway

Kilo Gateway 대시보드, API 키 및 계정 관리입니다.