Przejdź do głównej treści
Fireworks udostępnia modele open-weight i modele routowane przez API zgodne z OpenAI. Zainstaluj oficjalny Plugin dostawcy Fireworks, aby używać dwóch wstępnie skatalogowanych modeli Kimi oraz dowolnego modelu lub identyfikatora routera Fireworks w czasie działania.
WłaściwośćWartość
Identyfikator dostawcyfireworks (alias: fireworks-ai)
Pakiet@openclaw/fireworks-provider
Zmienna środowiskowa uwierzytelnianiaFIREWORKS_API_KEY
Flaga onboardingu--auth-choice fireworks-api-key
Bezpośrednia flaga CLI--fireworks-api-key <key>
APIzgodne z OpenAI (openai-completions)
Bazowy URLhttps://api.fireworks.ai/inference/v1
Model domyślnyfireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Alias domyślnyKimi K2.5 Turbo

Pierwsze kroki

1

Install the plugin

openclaw plugins install @openclaw/fireworks-provider
2

Set the Fireworks API key

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-...
Onboarding zapisuje klucz dla dostawcy fireworks w profilach uwierzytelniania i ustawia router Fire Pass Kimi K2.5 Turbo jako model domyślny.
3

Verify the model is available

openclaw models list --provider fireworks
Lista powinna zawierać Kimi K2.6 i Kimi K2.5 Turbo (Fire Pass). Jeśli FIREWORKS_API_KEY nie jest rozwiązany, openclaw models status --json zgłasza brakujące dane uwierzytelniające w auth.unusableProfiles.

Konfiguracja nieinteraktywna

W przypadku instalacji skryptowych lub CI przekaż wszystko w wierszu poleceń:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY" \
  --skip-health \
  --accept-risk

Wbudowany katalog

Odwołanie do modeluNazwaWejścieKontekstMaks. wyjścieMyślenie
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6tekst + obraz262,144262,144Wymuszone wyłączenie
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)tekst + obraz256,000256,000Wymuszone wyłączenie (domyślne)
OpenClaw przypina wszystkie modele Fireworks Kimi do thinking: off, ponieważ Fireworks odrzuca parametry myślenia Kimi w produkcji. Routowanie tego samego modelu bezpośrednio przez Moonshot zachowuje wynik rozumowania Kimi. Zobacz tryby myślenia, aby przełączać się między dostawcami.

Niestandardowe identyfikatory modeli Fireworks

OpenClaw akceptuje dowolny model lub identyfikator routera Fireworks w czasie działania. Użyj dokładnego identyfikatora pokazanego przez Fireworks i poprzedź go prefiksem fireworks/. Dynamiczne rozwiązywanie klonuje szablon Fire Pass (wejście tekst + obraz, API zgodne z OpenAI, domyślny koszt zero) i automatycznie wyłącza myślenie, gdy identyfikator pasuje do wzorca Kimi. Dynamiczne identyfikatory GLM są oznaczane jako wyłącznie tekstowe, chyba że skonfigurujesz niestandardowy wpis modelu z wejściem obrazu.
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
Każde odwołanie do modelu Fireworks w OpenClaw zaczyna się od fireworks/, po którym następuje dokładny identyfikator lub ścieżka routera z platformy Fireworks. Na przykład:
  • Model routera: fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
  • Model bezpośredni: fireworks/accounts/fireworks/models/<model-name>
OpenClaw usuwa prefiks fireworks/ podczas konstruowania żądania API i wysyła pozostałą ścieżkę do punktu końcowego Fireworks jako zgodne z OpenAI pole model.
Fireworks K2.6 zwraca błąd 400, jeśli żądanie zawiera parametry reasoning_*, mimo że Kimi obsługuje myślenie przez własne API Moonshot. Polityka dostawcy (extensions/fireworks/thinking-policy.ts) ogłasza tylko poziom myślenia off dla identyfikatorów modeli Kimi, dzięki czemu ręczne przełączniki /think i powierzchnie polityki dostawcy pozostają zgodne z kontraktem czasu działania.Aby używać rozumowania Kimi od początku do końca, skonfiguruj dostawcę Moonshot i routuj przez niego ten sam model.
Jeśli Gateway działa jako usługa zarządzana (launchd, systemd, Docker), klucz Fireworks musi być widoczny dla tego procesu — nie tylko dla interaktywnej powłoki.
Klucz wyeksportowany tylko w interaktywnej powłoce nie pomoże demonowi launchd ani systemd, chyba że to środowisko również zostanie tam zaimportowane. Ustaw klucz w ~/.openclaw/.env lub przez env.shellEnv, aby był czytelny z procesu gateway.
W macOS openclaw gateway install już podłącza ~/.openclaw/.env do pliku środowiska LaunchAgent. Uruchom instalację ponownie (lub openclaw doctor --fix) po rotacji klucza.

Powiązane

Model providers

Wybieranie dostawców, odwołań do modeli i zachowania przełączania awaryjnego.

Thinking modes

Poziomy /think, polityki dostawców i routowanie modeli zdolnych do rozumowania.

Moonshot

Uruchamiaj Kimi z natywnym wynikiem myślenia przez własne API Moonshot.

Troubleshooting

Ogólne rozwiązywanie problemów i FAQ.