2026-02-23 17:29:27 -06:00
|
|
|
---
|
|
|
|
|
summary: "Use Kilo Gateway's unified API to access many models in OpenClaw"
|
|
|
|
|
read_when:
|
|
|
|
|
- You want a single API key for many LLMs
|
|
|
|
|
- You want to run models via Kilo Gateway in OpenClaw
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Kilo Gateway
|
|
|
|
|
|
|
|
|
|
Kilo Gateway provides a **unified API** that routes requests to many models behind a single
|
|
|
|
|
endpoint and API key. It is OpenAI-compatible, so most OpenAI SDKs work by switching the base URL.
|
|
|
|
|
|
|
|
|
|
## Getting an API key
|
|
|
|
|
|
|
|
|
|
1. Go to [app.kilo.ai](https://app.kilo.ai)
|
|
|
|
|
2. Sign in or create an account
|
|
|
|
|
3. Navigate to API Keys and generate a new key
|
|
|
|
|
|
|
|
|
|
## CLI setup
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
openclaw onboard --kilocode-api-key <key>
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Or set the environment variable:
|
|
|
|
|
|
|
|
|
|
```bash
|
2026-03-06 19:35:26 -05:00
|
|
|
export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret
|
2026-02-23 17:29:27 -06:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Config snippet
|
|
|
|
|
|
|
|
|
|
```json5
|
|
|
|
|
{
|
2026-03-06 19:35:26 -05:00
|
|
|
env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret
|
2026-02-23 17:29:27 -06:00
|
|
|
agents: {
|
|
|
|
|
defaults: {
|
2026-03-07 10:14:06 -06:00
|
|
|
model: { primary: "kilocode/kilo/auto" },
|
2026-02-23 17:29:27 -06:00
|
|
|
},
|
|
|
|
|
},
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
2026-03-07 10:14:06 -06:00
|
|
|
## Default model
|
2026-02-23 21:17:37 -05:00
|
|
|
|
2026-03-07 10:14:06 -06:00
|
|
|
The default model is `kilocode/kilo/auto`, a smart routing model that automatically selects
|
|
|
|
|
the best underlying model based on the task:
|
2026-02-23 21:17:37 -05:00
|
|
|
|
2026-03-07 10:14:06 -06:00
|
|
|
- Planning, debugging, and orchestration tasks route to Claude Opus
|
|
|
|
|
- Code writing and exploration tasks route to Claude Sonnet
|
|
|
|
|
|
|
|
|
|
## Available models
|
|
|
|
|
|
|
|
|
|
OpenClaw dynamically discovers available models from the Kilo Gateway at startup. Use
|
|
|
|
|
`/models kilocode` to see the full list of models available with your account.
|
|
|
|
|
|
|
|
|
|
Any model available on the gateway can be used with the `kilocode/` prefix:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
kilocode/kilo/auto (default - smart routing)
|
|
|
|
|
kilocode/anthropic/claude-sonnet-4
|
|
|
|
|
kilocode/openai/gpt-5.2
|
|
|
|
|
kilocode/google/gemini-3-pro-preview
|
|
|
|
|
...and many more
|
|
|
|
|
```
|
2026-02-23 21:17:37 -05:00
|
|
|
|
2026-02-23 17:29:27 -06:00
|
|
|
## Notes
|
|
|
|
|
|
2026-03-07 10:14:06 -06:00
|
|
|
- Model refs are `kilocode/<model-id>` (e.g., `kilocode/anthropic/claude-sonnet-4`).
|
|
|
|
|
- Default model: `kilocode/kilo/auto`
|
2026-02-23 17:29:27 -06:00
|
|
|
- Base URL: `https://api.kilo.ai/api/gateway/`
|
|
|
|
|
- For more model/provider options, see [/concepts/model-providers](/concepts/model-providers).
|
|
|
|
|
- Kilo Gateway uses a Bearer token with your API key under the hood.
|
