Kilo Gateway Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: Kilo Gateway
개요
이 페이지는 OpenClaw Kilo Gateway provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: Use Kilo Gateway's unified API to access many models in OpenClaw
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
빠른 참조
| Property | Value |
|---|---|
| Provider | kilocode |
| Auth | KILOCODE_API_KEY |
| API | OpenAI-compatible |
| Base URL | https://api.kilo.ai/api/gateway/ |
공식 문서 기반 상세
아래는 공식 providers/kilocode 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
Kilo Gateway routes requests to many models behind a single OpenAI-compatible endpoint and API key.
| Property | Value |
|---|---|
| Provider | kilocode |
| Auth | KILOCODE_API_KEY |
| API | OpenAI-compatible |
| Base URL | https://api.kilo.ai/api/gateway/ |
Install plugin
openclaw plugins install @openclaw/kilocode-provider
openclaw gateway restart
설정
Create an account
Go to [app.kilo.ai](https://app.kilo.ai), sign in or create an account, then generate an API key.
Run onboarding
```bash
openclaw onboard --auth-choice kilocode-api-key
```
Or set the environment variable directly:
```bash
export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret
```
Verify the model is available
```bash
openclaw models list --provider kilocode
```
Default model and catalog
The default model is kilocode/kilo-auto/balanced, Kilo Gateway's balanced smart-routing tier.
OpenClaw does not publish a task-to-upstream-model mapping for it; routing behind
kilo-auto/balanced is owned by Kilo Gateway.
At startup OpenClaw queries GET https://api.kilo.ai/api/gateway/models and merges discovered models
ahead of a static fallback catalog. The static fallback contains only
kilocode/kilo-auto/balanced (Auto Balanced, input: ["text", "image"], reasoning: true,
contextWindow: 1000000, maxTokens: 65536).
Any model on the gateway is addressable as kilocode/<upstream-id> (for example
kilocode/anthropic/claude-sonnet-4, kilocode/openai/gpt-5.5). Run /models kilocode or
openclaw models list --provider kilocode to see the full discovered list.
설정 예시
{
env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret
agents: {
defaults: {
model: { primary: "kilocode/kilo-auto/balanced" },
},
},
}
Behavior notes
Transport and compatibility
Kilo Gateway is OpenRouter-compatible, so it uses the proxy-style OpenAI-compatible request
path rather than native OpenAI request shaping (no `store`, no OpenAI reasoning-effort payload).
- Gemini-backed Kilo refs stay on the proxy-Gemini path: OpenClaw sanitizes Gemini thought
signatures there but does not enable native Gemini replay validation or bootstrap rewrites.
- Requests use a Bearer token built from your API key.
Stream wrapper and reasoning
The Kilo stream wrapper adds an `X-KILOCODE-FEATURE` request header (default `openclaw`,
override with the `KILOCODE_FEATURE` env var) and normalizes reasoning-effort payloads for
models that support it.
kilocode/kilo-auto/balancedandx-ai/*refs skip reasoning-effort injection. Use a concrete model ref such askilocode/anthropic/claude-sonnet-4if you need reasoning support.
문제 해결
- If model discovery fails at startup, OpenClaw falls back to the static catalog containing `kilocode/kilo-auto/balanced`.
- Confirm your API key is valid and that your Kilo account has the desired models enabled.
- When Gateway runs as a daemon, ensure `KILOCODE_API_KEY` is available to that process (for example in `~/.openclaw/.env` or via `env.shellEnv`).
관련 문서
Choosing providers, model refs, and failover behavior.
Full OpenClaw configuration reference.
Kilo Gateway dashboard, API keys, and account management.
검증 체크리스트
-
openclaw models list --provider kilocode로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토