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

Providers

Vuurwerk

Fireworks biedt open-weight- en gerouteerde modellen aan via een OpenAI-compatibele API. Installeer de officiële Fireworks-providerplugin om tijdens runtime twee vooraf gecatalogiseerde Kimi-modellen en elk Fireworks-model of elke router-id te gebruiken.

Eigenschap Waarde
Provider-id fireworks (alias: fireworks-ai)
Pakket @openclaw/fireworks-provider
Omgevingsvariabele voor authenticatie FIREWORKS_API_KEY
Onboardingvlag --auth-choice fireworks-api-key
Rechtstreekse CLI-vlag --fireworks-api-key <key>
API OpenAI-compatibel (openai-completions)
Basis-URL https://api.fireworks.ai/inference/v1
Standaardmodel fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Standaardalias Kimi K2.5 Turbo

Aan de slag

  • Installeer de plugin

    bash
    openclaw plugins install @openclaw/fireworks-provider

  • Stel de Fireworks-API-sleutel in

    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-...

    Tijdens de onboarding wordt de sleutel voor de provider fireworks in uw authenticatieprofielen opgeslagen en wordt de Fire Pass Kimi K2.5 Turbo-router als standaardmodel ingesteld.

  • Controleer of het model beschikbaar is

    bash
    openclaw models list --provider fireworks

    De lijst moet Kimi K2.6 en Kimi K2.5 Turbo (Fire Pass) bevatten. Als FIREWORKS_API_KEY niet kan worden opgelost, meldt openclaw models status --json de ontbrekende referentie onder auth.unusableProfiles.

    • Niet-interactieve configuratie

    Geef voor installaties via scripts of CI alles mee op de opdrachtregel:

    bash
    openclaw onboard --non-interactive \  --mode local \  --auth-choice fireworks-api-key \  --fireworks-api-key "$FIREWORKS_API_KEY" \  --skip-health \  --accept-risk

    Ingebouwde catalogus

    Modelreferentie Naam Invoer Context Maximale uitvoer Denkmodus
    fireworks/accounts/fireworks/models/kimi-k2p6 Kimi K2.6 tekst + afbeelding 262,144 262,144 Verplicht uit
    fireworks/accounts/fireworks/routers/kimi-k2p5-turbo Kimi K2.5 Turbo (Fire Pass) tekst + afbeelding 256,000 256,000 Verplicht uit (standaard)

    Aangepaste Fireworks-model-id's

    OpenClaw accepteert tijdens runtime elke Fireworks-model- of router-id. Gebruik de exacte id die Fireworks toont en zet er fireworks/ voor. Dynamische omzetting kloont de Fire Pass-sjabloon (tekst- en afbeeldingsinvoer, OpenAI-compatibele API, standaardkosten nul) en schakelt de denkmodus automatisch uit wanneer de id overeenkomt met het Kimi-patroon. Dynamische GLM-id's worden gemarkeerd als uitsluitend geschikt voor tekst, tenzij u een aangepaste modelvermelding met afbeeldingsinvoer configureert.

    json5
    {  agents: {    defaults: {      model: {        primary: "fireworks/accounts/fireworks/models/<your-model-id>",      },    },  },}
    Hoe voorvoeging van model-id's werkt

    Elke Fireworks-modelreferentie in OpenClaw begint met fireworks/, gevolgd door de exacte id of het routerpad van het Fireworks-platform. Bijvoorbeeld:

    • Routermodel: fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
    • Rechtstreeks model: fireworks/accounts/fireworks/models/<model-name>

    OpenClaw verwijdert het voorvoegsel fireworks/ bij het opstellen van het API-verzoek en verzendt het resterende pad als het OpenAI-compatibele veld model naar het Fireworks-eindpunt.

    Waarom de denkmodus voor Kimi verplicht is uitgeschakeld

    Fireworks biedt Kimi aan zonder afzonderlijk redeneerkanaal, waardoor de redeneerketen zichtbaar kan worden in de content-stream. Bij elk Fireworks Kimi-verzoek verzendt OpenClaw thinking: { type: "disabled" } en verwijdert het reasoning, reasoning_effort en reasoningEffort uit de payload (extensions/fireworks/stream.ts). Het providerbeleid (extensions/fireworks/thinking-policy.ts) maakt voor Kimi-model-id's alleen het denkniveau off beschikbaar, zodat handmatige /think-wisselingen en providerbeleidsonderdelen in overeenstemming blijven met het runtimecontract.

    Als u de redeneermogelijkheden van Kimi van begin tot eind wilt gebruiken, configureert u de Moonshot-provider en routeert u hetzelfde model via deze provider.

    Beschikbaarheid van de omgeving voor de daemon

    Als de Gateway als beheerde service wordt uitgevoerd (launchd, systemd, Docker), moet de Fireworks-sleutel zichtbaar zijn voor dat proces, niet alleen voor uw interactieve shell.

    OpenClaw laadt ~/.openclaw/.env bij het laden van de configuratie, zodat sleutels die daar zijn opgeslagen op elk platform beschikbaar zijn voor beheerde Gateway-services. Start de Gateway opnieuw (of voer openclaw doctor --fix opnieuw uit) nadat u de sleutel hebt vervangen.

    Gerelateerd

    Modelproviders

    Providers, modelreferenties en failovergedrag kiezen.
    Denkmodi

    /think-niveaus, providerbeleid en het routeren van modellen met redeneermogelijkheden.
    Moonshot

    Voer Kimi met native denkuitvoer uit via de eigen API van Moonshot.
    Problemen oplossen

    Algemene probleemoplossing en veelgestelde vragen.
    Was this useful?
    On this page

    On this page