> ## 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.

# Fireworks

[Fireworks](https://fireworks.ai) предоставляет модели с открытыми весами и маршрутизацией через API, совместимый с OpenAI. Установите официальный плагин провайдера Fireworks, чтобы использовать две предварительно добавленные в каталог модели Kimi, а также любую модель Fireworks или идентификатор маршрутизатора во время выполнения.

| Свойство | Значение |
| - | - |
| Идентификатор провайдера | `fireworks` (псевдоним: `fireworks-ai`) |
| Пакет | `@openclaw/fireworks-provider` |
| Переменная окружения для аутентификации | `FIREWORKS_API_KEY` |
| Флаг первоначальной настройки | `--auth-choice fireworks-api-key` |
| Прямой флаг CLI | `--fireworks-api-key <key>` |
| API | Совместимый с OpenAI (`openai-completions`) |
| Базовый URL | `https://api.fireworks.ai/inference/v1` |
| Модель по умолчанию | `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo` |
| Псевдоним по умолчанию | `Kimi K2.5 Turbo` |

## Начало работы

**1. Установите плагин**

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

**2. Укажите ключ API Fireworks**

```bash Первоначальная настройка theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice fireworks-api-key
```

```bash Прямой флаг theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY"
```

```bash Только переменная окружения theme={"theme":{"light":"min-light","dark":"min-dark"}}
export FIREWORKS_API_KEY=fw-...
```

При первоначальной настройке ключ сохраняется для провайдера `fireworks` в ваших профилях аутентификации, а маршрутизатор Kimi K2.5 Turbo **Fire Pass** назначается моделью по умолчанию.

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider fireworks
```

Список должен содержать `Kimi K2.6` и `Kimi K2.5 Turbo (Fire Pass)`. Если `FIREWORKS_API_KEY` не разрешается, `openclaw models status --json` сообщает об отсутствующих учётных данных в разделе `auth.unusableProfiles`.

## Неинтерактивная настройка

Для установки с помощью скриптов или в CI передайте все параметры в командной строке:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY" \
  --skip-health \
  --accept-risk
```

## Встроенный каталог

| Ссылка на модель | Название | Входные данные | Контекст | Макс. объём вывода | Рассуждение |
| - | - | - | - | - | - |
| `fireworks/accounts/fireworks/models/kimi-k2p6` | Kimi K2.6 | текст + изображение | 262,144 | 262,144 | Принудительно отключено |
| `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo` | Kimi K2.5 Turbo (Fire Pass) | текст + изображение | 256,000 | 256,000 | Принудительно отключено (по умолчанию) |

> [!NOTE]
>
> OpenClaw закрепляет для всех моделей Kimi в Fireworks значение `thinking: off`, поскольку Kimi в Fireworks может раскрывать цепочку рассуждений в видимом ответе, если запрос явно не отключает рассуждение. Маршрутизация той же модели напрямую через [Moonshot](https://docs2.openclaw.ai/ru/providers/moonshot.md) сохраняет вывод рассуждений Kimi. Инструкции по переключению между провайдерами см. в разделе [режимы рассуждения](https://docs2.openclaw.ai/ru/tools/thinking.md).

## Пользовательские идентификаторы моделей Fireworks

OpenClaw принимает во время выполнения любую модель Fireworks или идентификатор маршрутизатора. Используйте точный идентификатор, указанный Fireworks, и добавьте к нему префикс `fireworks/`. При динамическом разрешении клонируется шаблон Fire Pass (ввод текста и изображений, API, совместимый с OpenAI, нулевая стоимость по умолчанию), а если идентификатор соответствует шаблону Kimi, рассуждение автоматически отключается. Динамические идентификаторы GLM помечаются как поддерживающие только текст, если вы не настроите пользовательскую запись модели с поддержкой изображений на входе.

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
```

> [accordion] Как работает добавление префикса к идентификатору модели
>
> Каждая ссылка на модель Fireworks в OpenClaw начинается с `fireworks/`, после которого следует точный идентификатор или путь маршрутизатора с платформы Fireworks. Например:
>
> * Модель маршрутизатора: `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo`
> * Прямая модель: `fireworks/accounts/fireworks/models/<model-name>`
>
> При формировании запроса API OpenClaw удаляет префикс `fireworks/` и отправляет оставшийся путь в конечную точку Fireworks как поле `model`, совместимое с OpenAI.

> [accordion] Почему для Kimi рассуждение принудительно отключено
>
> Fireworks предоставляет Kimi без отдельного канала рассуждений, поэтому цепочка рассуждений может появляться в видимом потоке `content`. В каждом запросе к Kimi через Fireworks OpenClaw отправляет `thinking: { type: "disabled" }` и удаляет из полезной нагрузки `reasoning`, `reasoning_effort` и `reasoningEffort` (`extensions/fireworks/stream.ts`). Политика провайдера (`extensions/fireworks/thinking-policy.ts`) объявляет для идентификаторов моделей Kimi только уровень рассуждения `off`, поэтому ручные переключатели `/think` и поверхности политики провайдера остаются согласованными с контрактом среды выполнения.
>
> Чтобы использовать рассуждения Kimi на всём пути обработки, настройте [провайдер Moonshot](https://docs2.openclaw.ai/ru/providers/moonshot.md) и направьте ту же модель через него.

> [accordion] Доступность переменной окружения для демона
>
> Если Gateway работает как управляемая служба (launchd, systemd, Docker), ключ Fireworks должен быть доступен этому процессу, а не только вашей интерактивной оболочке.
>
> > [!WARNING]
> >
> > Ключ, экспортированный только в интерактивной оболочке, не будет доступен демону launchd или systemd, если это окружение не импортировано и туда. Укажите ключ в `~/.openclaw/.env` или через `env.shellEnv`, чтобы процесс Gateway мог его прочитать.
>
> OpenClaw загружает `~/.openclaw/.env` при загрузке конфигурации, поэтому сохранённые там ключи доступны управляемым службам Gateway на всех платформах. После ротации ключа перезапустите Gateway или повторно выполните `openclaw doctor --fix`.

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

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

> [card] [Режимы рассуждения](https://docs2.openclaw.ai/ru/tools/thinking.md)
>
> Уровни `/think`, политики провайдеров и маршрутизация моделей с поддержкой рассуждений.

> [card] [Moonshot](https://docs2.openclaw.ai/ru/providers/moonshot.md)
>
> Запускайте Kimi с нативным выводом рассуждений через собственный API Moonshot.

> [card] [Устранение неполадок](https://docs2.openclaw.ai/ru/help/troubleshooting.md)
>
> Общие инструкции по устранению неполадок и часто задаваемые вопросы.
