OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Fireworks

Fireworks предоставляет модели с открытыми весами и маршрутизацией через 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

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

  • Установите плагин

    bash
    openclaw plugins install @openclaw/fireworks-provider

  • Укажите ключ API Fireworks

    Первоначальная настройка
    openclaw onboard --auth-choice fireworks-api-key
    Прямой флаг
    openclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"
    Только переменная окружения
    export FIREWORKS_API_KEY=fw-...

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

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

    bash
    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
    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 Принудительно отключено (по умолчанию)

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

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

    json5
    {  agents: {    defaults: {      model: {        primary: "fireworks/accounts/fireworks/models/<your-model-id>",      },    },  },}
    Как работает добавление префикса к идентификатору модели

    Каждая ссылка на модель Fireworks в OpenClaw начинается с fireworks/, после которого следует точный идентификатор или путь маршрутизатора с платформы Fireworks. Например:

    • Модель маршрутизатора: fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
    • Прямая модель: fireworks/accounts/fireworks/models/<model-name>

    При формировании запроса API OpenClaw удаляет префикс fireworks/ и отправляет оставшийся путь в конечную точку Fireworks как поле model, совместимое с OpenAI.

    Почему для 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 и направьте ту же модель через него.

    Доступность переменной окружения для демона

    Если Gateway работает как управляемая служба (launchd, systemd, Docker), ключ Fireworks должен быть доступен этому процессу, а не только вашей интерактивной оболочке.

    OpenClaw загружает ~/.openclaw/.env при загрузке конфигурации, поэтому сохранённые там ключи доступны управляемым службам Gateway на всех платформах. После ротации ключа перезапустите Gateway или повторно выполните openclaw doctor --fix.

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

    Провайдеры моделей

    Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.
    Режимы рассуждения

    Уровни /think, политики провайдеров и маршрутизация моделей с поддержкой рассуждений.
    Moonshot

    Запускайте Kimi с нативным выводом рассуждений через собственный API Moonshot.
    Устранение неполадок

    Общие инструкции по устранению неполадок и часто задаваемые вопросы.
    Was this useful?
    On this page

    On this page