> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kilo Gateway

Kilo Gateway направляет запросы к множеству моделей через единую конечную точку, совместимую с OpenAI, и один ключ API.

| Свойство | Значение |
| - | - |
| Провайдер | `kilocode` |
| Авторизация | `KILOCODE_API_KEY` |
| API | Совместимый с OpenAI |
| Базовый URL | `https://api.kilo.ai/api/gateway/` |

## Установка плагина

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/kilocode-provider
openclaw gateway restart
```

## Настройка

**1. Создайте учётную запись**

Перейдите на [app.kilo.ai](https://app.kilo.ai), войдите или создайте учётную запись, затем сгенерируйте ключ API.

**2. Запустите первоначальную настройку**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice kilocode-api-key
```

Или задайте переменную окружения напрямую:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret
```

**3. Убедитесь, что модель доступна**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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`, чтобы просмотреть полный список обнаруженных моделей.

## Пример конфигурации

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret
  agents: {
    defaults: {
      model: { primary: "kilocode/kilo/auto" },
    },
  },
}
```

## Примечания о поведении

> [accordion] Транспорт и совместимость
>
> Kilo Gateway совместим с OpenRouter, поэтому использует прокси-путь запросов, совместимый с OpenAI,
> вместо формирования нативных запросов OpenAI (без `store` и без полезной нагрузки OpenAI для уровня рассуждений).
>
> * Ссылки Kilo на базе Gemini остаются на прокси-пути Gemini: OpenClaw очищает там сигнатуры
>   рассуждений Gemini, но не включает нативную проверку воспроизведения Gemini или перезапись начальной загрузки.
> * В запросах используется токен Bearer, сформированный из вашего ключа API.

> [accordion] Обёртка потока и рассуждения
>
> Обёртка потока Kilo добавляет к запросу заголовок `X-KILOCODE-FEATURE` (по умолчанию `openclaw`,
> переопределяется переменной окружения `KILOCODE_FEATURE`) и нормализует полезную нагрузку уровня рассуждений для
> поддерживающих её моделей.
>
> > [!WARNING]
> >
> > Для ссылок `kilocode/kilo/auto` и `x-ai/*` внедрение уровня рассуждений пропускается. Если вам нужна поддержка
> > рассуждений, используйте ссылку на конкретную модель, например `kilocode/anthropic/claude-sonnet-4`.

> [accordion] Устранение неполадок
>
> * Если при запуске не удаётся обнаружить модели, OpenClaw использует статический резервный каталог, содержащий `kilocode/kilo/auto`.
> * Убедитесь, что ваш ключ API действителен и в вашей учётной записи Kilo включены нужные модели.
> * Если Gateway работает как демон, убедитесь, что `KILOCODE_API_KEY` доступна этому процессу (например, в `~/.openclaw/.env` или через `env.shellEnv`).

## Связанные материалы

> [card] [Выбор модели](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

> [card] [Справочник по конфигурации](https://docs2.openclaw.ai/ru/gateway/configuration-reference.md)
>
> Полный справочник по конфигурации OpenClaw.

> [card] [Kilo Gateway](https://app.kilo.ai)
>
> Панель управления Kilo Gateway, ключи API и управление учётной записью.
