Providers
Kilo Gateway
Kilo Gateway는 단일 OpenAI 호환 엔드포인트와 API 키를 통해 여러 모델로 요청을 라우팅합니다.
| 속성 | 값 |
|---|---|
| 제공자 | kilocode |
| 인증 | KILOCODE_API_KEY |
| API | OpenAI 호환 |
| 기본 URL | https://api.kilo.ai/api/gateway/ |
Plugin 설치
openclaw plugins install @openclaw/kilocode-provideropenclaw gateway restart설정
계정 만들기
app.kilo.ai로 이동하여 로그인하거나 계정을 만든 다음 API 키를 생성합니다.
온보딩 실행
openclaw onboard --auth-choice kilocode-api-key또는 환경 변수를 직접 설정합니다.
export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret모델 사용 가능 여부 확인
openclaw models list --provider kilocode기본 모델 및 카탈로그
기본 모델은 제공자가 관리하는 스마트 라우팅 모델인 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를 실행합니다.
구성 예시
{ env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret agents: { defaults: { model: { primary: "kilocode/kilo/auto" }, }, },}동작 참고 사항
전송 및 호환성
Kilo Gateway는 OpenRouter와 호환되므로 네이티브 OpenAI 요청 형식 대신 프록시 방식의
OpenAI 호환 요청 경로를 사용합니다(store 없음, OpenAI 추론 노력 수준 페이로드 없음).
- Gemini 기반 Kilo 참조는 프록시 Gemini 경로를 계속 사용합니다. OpenClaw는 이 경로에서 Gemini 사고 서명을 정리하지만 네이티브 Gemini 재실행 검증 또는 부트스트랩 재작성은 활성화하지 않습니다.
- 요청은 API 키로 생성한 Bearer 토큰을 사용합니다.
스트림 래퍼 및 추론
Kilo 스트림 래퍼는 X-KILOCODE-FEATURE 요청 헤더를 추가하고(기본값 openclaw,
KILOCODE_FEATURE 환경 변수로 재정의 가능), 이를 지원하는 모델의 추론 노력 수준 페이로드를
정규화합니다.
문제 해결
- 시작 시 모델 검색에 실패하면 OpenClaw는
kilocode/kilo/auto가 포함된 정적 카탈로그를 대신 사용합니다. - API 키가 유효하며 Kilo 계정에서 원하는 모델이 활성화되어 있는지 확인하세요.
- Gateway가 데몬으로 실행되는 경우 해당 프로세스에서
KILOCODE_API_KEY를 사용할 수 있는지 확인하세요(예:~/.openclaw/.env또는env.shellEnv사용).
