Providers
Феєрверки
Fireworks надає open-weight і маршрутизовані моделі через API, сумісний з OpenAI. Установіть офіційний provider Plugin Fireworks, щоб використовувати дві попередньо каталогізовані моделі Kimi та будь-яку модель або router id Fireworks під час виконання.
| Властивість | Значення |
|---|---|
| Provider id | fireworks (псевдонім: fireworks-ai) |
| Пакет | @openclaw/fireworks-provider |
| Auth env var | FIREWORKS_API_KEY |
| Прапорець онбордингу | --auth-choice fireworks-api-key |
| Прямий прапорець CLI | --fireworks-api-key <key> |
| API | сумісний з OpenAI (openai-completions) |
| Base URL | https://api.fireworks.ai/inference/v1 |
| Модель за замовчуванням | fireworks/accounts/fireworks/routers/kimi-k2p5-turbo |
| Псевдонім за замовчуванням | Kimi K2.5 Turbo |
Початок роботи
Установіть Plugin
openclaw plugins install @openclaw/fireworks-providerЗадайте API-ключ Fireworks
openclaw onboard --auth-choice fireworks-api-keyopenclaw 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 як модель за замовчуванням.
Перевірте, що модель доступна
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-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 | Примусово вимкнено (за замовчуванням) |
Власні 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 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.
Чому thinking для Kimi примусово вимкнено
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 і маршрутизуйте ту саму модель через нього.
Доступність середовища для daemon
Якщо Gateway працює як керований сервіс (launchd, systemd, Docker), ключ Fireworks має бути видимий цьому процесу — не лише вашій інтерактивній оболонці.
У macOS openclaw gateway install уже під’єднує ~/.openclaw/.env до файла середовища LaunchAgent. Повторно запустіть install (або openclaw doctor --fix) після ротації ключа.
Пов’язане
Вибір providers, model refs і поведінки failover.
Рівні /think, політики provider і маршрутизація моделей із підтримкою reasoning.
Запускайте Kimi з нативним виводом thinking через власний API Moonshot.
Загальне усунення несправностей і FAQ.
