Перейти до основного вмісту
Fireworks надає open-weight і маршрутизовані моделі через API, сумісний з OpenAI. Установіть офіційний provider Plugin Fireworks, щоб використовувати дві попередньо каталогізовані моделі Kimi та будь-яку модель або router id Fireworks під час виконання.
ВластивістьЗначення
Provider idfireworks (псевдонім: fireworks-ai)
Пакет@openclaw/fireworks-provider
Auth env varFIREWORKS_API_KEY
Прапорець онбордингу--auth-choice fireworks-api-key
Прямий прапорець CLI--fireworks-api-key <key>
APIсумісний з OpenAI (openai-completions)
Base URLhttps://api.fireworks.ai/inference/v1
Модель за замовчуваннямfireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Псевдонім за замовчуваннямKimi K2.5 Turbo

Початок роботи

1

Установіть Plugin

openclaw plugins install @openclaw/fireworks-provider
2

Задайте 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-...
Онбординг зберігає ключ для provider fireworks у ваших профілях автентифікації та встановлює router Fire Pass Kimi K2.5 Turbo як модель за замовчуванням.
3

Перевірте, що модель доступна

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

Вбудований каталог

Model refНазваВвідКонтекстМакс. вивідThinking
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 закріплює всі моделі Kimi Fireworks за thinking: off, оскільки Fireworks відхиляє параметри thinking Kimi у production. Маршрутизація тієї самої моделі напряму через Moonshot зберігає вивід reasoning Kimi. Дивіться режими thinking, щоб перемикатися між providers.

Власні id моделей Fireworks

OpenClaw приймає будь-яку модель або router id Fireworks під час виконання. Використовуйте точний id, показаний Fireworks, і додайте до нього префікс fireworks/. Динамічне розв’язання клонує шаблон Fire Pass (ввід тексту + зображення, API, сумісний з OpenAI, вартість за замовчуванням нуль) і автоматично вимикає thinking, коли id відповідає шаблону Kimi. Динамічні id GLM позначаються як текстові, якщо ви не налаштуєте власний запис моделі з вводом зображень.
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
Кожен model ref Fireworks в OpenClaw починається з fireworks/, після якого йде точний id або шлях router з платформи Fireworks. Наприклад:
  • Модель router: fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
  • Пряма модель: fireworks/accounts/fireworks/models/<model-name>
OpenClaw відкидає префікс fireworks/ під час створення API-запиту та надсилає решту шляху до endpoint Fireworks як сумісне з OpenAI поле model.
Fireworks K2.6 повертає 400, якщо запит містить параметри reasoning_*, хоча Kimi підтримує thinking через власний API Moonshot. Політика provider (extensions/fireworks/thinking-policy.ts) оголошує для id моделей Kimi лише рівень thinking off, тож ручні перемикачі /think і поверхні provider-policy залишаються узгодженими з контрактом runtime.Щоб використовувати reasoning Kimi наскрізно, налаштуйте provider Moonshot і маршрутизуйте ту саму модель через нього.
Якщо Gateway працює як керований сервіс (launchd, systemd, Docker), ключ Fireworks має бути видимий цьому процесу — не лише вашій інтерактивній оболонці.
Ключ, експортований лише в інтерактивній оболонці, не допоможе daemon launchd або systemd, якщо це середовище також не імпортовано туди. Задайте ключ у ~/.openclaw/.env або через env.shellEnv, щоб процес gateway міг його прочитати.
У macOS openclaw gateway install уже під’єднує ~/.openclaw/.env до файла середовища LaunchAgent. Повторно запустіть install (або openclaw doctor --fix) після ротації ключа.

Пов’язане

Providers моделей

Вибір providers, model refs і поведінки failover.

Режими thinking

Рівні /think, політики provider і маршрутизація моделей із підтримкою reasoning.

Moonshot

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

Усунення несправностей

Загальне усунення несправностей і FAQ.