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

Providers

Fireworks

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
Onboarding-vlag --auth-choice fireworks-api-key
Directe 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-k2p6-turbo
Standaardalias Kimi K2.6 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
    Directe vlag
    openclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"
    Alleen omgeving
    export FIREWORKS_API_KEY=fw-...

    Onboarding slaat de sleutel voor de provider fireworks op in je authenticatieprofielen en stelt de Kimi K2.6 Turbo-router Fire Pass in als standaardmodel.

  • Controleer of het model beschikbaar is

    bash
    openclaw models list --provider fireworks

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

    • Niet-interactieve configuratie

    Geef voor gescripte installaties of CI-installaties alles op via 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 Thinking
    fireworks/accounts/fireworks/models/kimi-k2p6 Kimi K2.6 tekst + afbeelding 262,144 262,144 Gedwongen uit
    fireworks/accounts/fireworks/routers/kimi-k2p6-turbo Kimi K2.6 Turbo (Fire Pass) tekst + afbeelding 256,000 256,000 Gedwongen 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 voeg het voorvoegsel fireworks/ toe. Dynamische omzetting kloont de Fire Pass-sjabloon (tekst- en afbeeldingsinvoer, OpenAI-compatibele API, standaardkosten nul) en schakelt Thinking automatisch uit wanneer de id overeenkomt met het Kimi-patroon. Dynamische GLM-id's worden gemarkeerd als uitsluitend tekst, tenzij je een aangepaste modelvermelding met afbeeldingsinvoer configureert.

    json5
    {  agents: {    defaults: {      model: {        primary: "fireworks/accounts/fireworks/models/<your-model-id>",      },    },  },}
    Hoe het voorvoegsel voor 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-k2p6-turbo
    • Rechtstreeks model: fireworks/accounts/fireworks/models/<model-name>

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

    Waarom Thinking voor Kimi gedwongen wordt uitgeschakeld

    Fireworks levert Kimi 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) biedt voor Kimi-model-id's alleen het Thinking-niveau off aan, zodat handmatige /think-schakelaars en providerbeleidsonderdelen afgestemd blijven op het runtimecontract.

    Om Kimi-redenering van begin tot eind te gebruiken, configureer je de Moonshot-provider en routeer je 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 je interactieve shell.

    OpenClaw laadt ~/.openclaw/.env wanneer de configuratie wordt geladen, zodat sleutels die daar zijn opgeslagen op elk platform de beheerde gatewayservices bereiken. Start de gateway opnieuw (of voer openclaw doctor --fix opnieuw uit) nadat je de sleutel hebt vervangen.

    Gerelateerd

    Modelproviders

    Providers, modelreferenties en failovergedrag kiezen.
    Thinking-modi

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

    Voer Kimi met native Thinking-uitvoer uit via de eigen API van Moonshot.
    Probleemoplossing

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

    On this page