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

Providers

Fajerwerki

Fireworks udostępnia modele o otwartych wagach i modele trasowane za pośrednictwem interfejsu API zgodnego z OpenAI. Zainstaluj oficjalny plugin dostawcy Fireworks, aby korzystać w czasie działania z dwóch wstępnie skatalogowanych modeli Kimi oraz dowolnego modelu Fireworks lub identyfikatora routera.

Właściwość Wartość
Identyfikator dostawcy fireworks (alias: fireworks-ai)
Pakiet @openclaw/fireworks-provider
Zmienna środowiskowa uwierzytelniania FIREWORKS_API_KEY
Flaga wdrażania --auth-choice fireworks-api-key
Bezpośrednia flaga CLI --fireworks-api-key <key>
API zgodne z OpenAI (openai-completions)
Bazowy adres URL https://api.fireworks.ai/inference/v1
Model domyślny fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Alias domyślny Kimi K2.5 Turbo

Pierwsze kroki

  • Zainstaluj plugin

    bash
    openclaw plugins install @openclaw/fireworks-provider

  • Ustaw klucz API Fireworks

    Onboarding
    openclaw onboard --auth-choice fireworks-api-key
    Direct flag
    openclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"
    Env only
    export FIREWORKS_API_KEY=fw-...

    Proces wdrażania zapisuje klucz dla dostawcy fireworks w profilach uwierzytelniania i ustawia router Kimi K2.5 Turbo Fire Pass jako model domyślny.

  • Sprawdź dostępność modelu

    bash
    openclaw models list --provider fireworks

    Lista powinna zawierać Kimi K2.6 i Kimi K2.5 Turbo (Fire Pass). Jeśli nie można rozpoznać wartości FIREWORKS_API_KEY, polecenie openclaw models status --json zgłasza brakujące dane uwierzytelniające w auth.unusableProfiles.

    • Konfiguracja nieinteraktywna

    W przypadku instalacji skryptowych lub w CI przekaż wszystkie parametry w wierszu poleceń:

    bash
    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 modelu Nazwa Dane wejściowe Kontekst Maks. dane wyjściowe Myślenie
    fireworks/accounts/fireworks/models/kimi-k2p6 Kimi K2.6 tekst + obraz 262,144 262,144 Wymuszone wyłączenie
    fireworks/accounts/fireworks/routers/kimi-k2p5-turbo Kimi K2.5 Turbo (Fire Pass) tekst + obraz 256,000 256,000 Wymuszone wyłączenie (domyślne)

    Niestandardowe identyfikatory modeli Fireworks

    OpenClaw akceptuje w czasie działania dowolny model Fireworks lub identyfikator routera. Użyj dokładnego identyfikatora wyświetlanego przez Fireworks i poprzedź go prefiksem fireworks/. Dynamiczne rozpoznawanie klonuje szablon Fire Pass (tekst i obraz na wejściu, API zgodne z OpenAI, domyślny koszt równy zero) i automatycznie wyłącza myślenie, gdy identyfikator pasuje do wzorca Kimi. Dynamiczne identyfikatory GLM są oznaczane jako obsługujące wyłącznie tekst, chyba że skonfigurujesz niestandardowy wpis modelu z obrazem na wejściu.

    json5
    {  agents: {    defaults: {      model: {        primary: "fireworks/accounts/fireworks/models/<your-model-id>",      },    },  },}
    Jak działa dodawanie prefiksu do identyfikatora modelu

    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>

    Podczas konstruowania żądania API OpenClaw usuwa prefiks fireworks/ i wysyła pozostałą ścieżkę do punktu końcowego Fireworks jako zgodne z OpenAI pole model.

    Dlaczego myślenie jest wymuszenie wyłączone dla Kimi

    Fireworks udostępnia Kimi bez osobnego kanału rozumowania, dlatego tok rozumowania może pojawić się w widocznym strumieniu content. Przy każdym żądaniu Kimi w Fireworks OpenClaw wysyła thinking: { type: "disabled" } i usuwa z ładunku pola reasoning, reasoning_effort oraz reasoningEffort (extensions/fireworks/stream.ts). Zasady dostawcy (extensions/fireworks/thinking-policy.ts) udostępniają dla identyfikatorów modeli Kimi wyłącznie poziom myślenia off, dzięki czemu ręczne przełączniki /think i powierzchnie zasad dostawcy pozostają zgodne z kontraktem środowiska wykonawczego.

    Aby korzystać z rozumowania Kimi w całym przepływie, skonfiguruj dostawcę Moonshot i trasuj przez niego ten sam model.

    Dostępność środowiska dla demona

    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.

    OpenClaw wczytuje ~/.openclaw/.env podczas wczytywania konfiguracji, dlatego zapisane tam klucze są dostępne dla zarządzanych usług Gateway na każdej platformie. Po zmianie klucza uruchom ponownie Gateway (lub ponownie wykonaj openclaw doctor --fix).

    Powiązane materiały

    Dostawcy modeli

    Wybór dostawców, odwołań do modeli i zachowania mechanizmu przełączania awaryjnego.
    Tryby myślenia

    Poziomy /think, zasady dostawców i trasowanie modeli obsługujących rozumowanie.
    Moonshot

    Uruchamianie Kimi z natywnymi danymi wyjściowymi myślenia za pośrednictwem własnego API Moonshot.
    Rozwiązywanie problemów

    Ogólne rozwiązywanie problemów i często zadawane pytania.
    Was this useful?
    On this page

    On this page