Перейти к основному содержанию
Fireworks предоставляет open-weight и маршрутизируемые модели через API, совместимый с OpenAI. Установите официальный Plugin провайдера 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)
Базовый URLhttps://api.fireworks.ai/inference/v1
Модель по умолчаниюfireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Псевдоним по умолчаниюKimi K2.5 Turbo

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

1

Install the plugin

openclaw plugins install @openclaw/fireworks-provider
2

Set the Fireworks API key

openclaw onboard --auth-choice fireworks-api-key
Онбординг сохраняет ключ для провайдера fireworks в ваших профилях авторизации и устанавливает маршрутизатор Fire Pass Kimi K2.5 Turbo как модель по умолчанию.
3

Verify the model is available

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

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

Для скриптовых установок или установок в CI передайте все параметры в командной строке:
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-k2p6Kimi K2.6текст + изображение262,144262,144Принудительно выключено
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)текст + изображение256,000256,000Принудительно выключено (по умолчанию)
OpenClaw закрепляет для всех моделей Fireworks Kimi значение thinking: off, потому что Fireworks отклоняет параметры thinking Kimi в продакшене. Маршрутизация той же модели напрямую через Moonshot сохраняет вывод рассуждений Kimi. См. режимы thinking, чтобы переключаться между провайдерами.

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

OpenClaw принимает любой идентификатор модели или маршрутизатора Fireworks во время выполнения. Используйте точный идентификатор, показанный Fireworks, и добавьте к нему префикс fireworks/. Динамическое разрешение клонирует шаблон Fire Pass (ввод текста + изображения, API, совместимый с OpenAI, стоимость по умолчанию ноль) и автоматически отключает thinking, когда идентификатор совпадает с шаблоном Kimi. Динамические идентификаторы GLM помечаются как поддерживающие только текст, если вы не настроите пользовательскую запись модели с вводом изображений.
{
  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>
OpenClaw удаляет префикс fireworks/ при создании API-запроса и отправляет оставшийся путь в конечную точку Fireworks как совместимое с OpenAI поле model.
Fireworks K2.6 возвращает 400, если запрос содержит параметры reasoning_*, хотя Kimi поддерживает thinking через собственный API Moonshot. Политика провайдера (extensions/fireworks/thinking-policy.ts) объявляет для идентификаторов моделей Kimi только уровень thinking off, поэтому ручные переключения /think и поверхности политик провайдера остаются согласованными с контрактом среды выполнения.Чтобы использовать рассуждения Kimi от начала до конца, настройте провайдера Moonshot и маршрутизируйте ту же модель через него.
Если Gateway запускается как управляемая служба (launchd, systemd, Docker), ключ Fireworks должен быть виден этому процессу, а не только вашей интерактивной оболочке.
Ключ, экспортированный только в интерактивной оболочке, не поможет демону launchd или systemd, если это окружение также не импортировано туда. Задайте ключ в ~/.openclaw/.env или через env.shellEnv, чтобы сделать его доступным для чтения из процесса gateway.
В macOS openclaw gateway install уже подключает ~/.openclaw/.env к файлу окружения LaunchAgent. После ротации ключа повторно выполните установку (или openclaw doctor --fix).

См. также

Model providers

Выбор провайдеров, ссылок на модели и поведения failover.

Thinking modes

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

Moonshot

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

Troubleshooting

Общая диагностика и часто задаваемые вопросы.