Naar hoofdinhoud gaan
Fireworks biedt open-weight en gerouteerde modellen aan via een OpenAI-compatibele API. Installeer de officiële Fireworks-providerplugin om twee vooraf gecatalogiseerde Kimi-modellen en elke Fireworks-model- of router-id tijdens runtime te gebruiken.
EigenschapWaarde
Provider-idfireworks (alias: fireworks-ai)
Pakket@openclaw/fireworks-provider
Auth-env-varFIREWORKS_API_KEY
Onboarding-flag--auth-choice fireworks-api-key
Directe CLI-flag--fireworks-api-key <key>
APIOpenAI-compatibel (openai-completions)
Basis-URLhttps://api.fireworks.ai/inference/v1
Standaardmodelfireworks/accounts/fireworks/routers/kimi-k2p5-turbo
StandaardaliasKimi K2.5 Turbo

Aan de slag

1

Installeer de plugin

openclaw plugins install @openclaw/fireworks-provider
2

Stel de Fireworks API-sleutel in

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 slaat de sleutel op voor de fireworks-provider in je auth-profielen en stelt de Fire Pass Kimi K2.5 Turbo-router in als standaardmodel.
3

Controleer of het model beschikbaar is

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, rapporteert openclaw models status --json de ontbrekende referentie onder auth.unusableProfiles.

Niet-interactieve setup

Geef voor scripted of CI-installaties alles op de opdrachtregel door:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY" \
  --skip-health \
  --accept-risk

Ingebouwde catalogus

Model-refNaamInvoerContextMax. uitvoerThinking
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6tekst + afbeelding262,144262,144Gedwongen uit
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)tekst + afbeelding256,000256,000Gedwongen uit (standaard)
OpenClaw zet alle Fireworks Kimi-modellen vast op thinking: off, omdat Fireworks Kimi-thinkingparameters in productie weigert. Hetzelfde model rechtstreeks via Moonshot routeren behoudt Kimi-redeneeruitvoer. Zie thinking-modi om tussen providers te wisselen.

Aangepaste Fireworks-model-id’s

OpenClaw accepteert elke Fireworks-model- of router-id tijdens runtime. Gebruik de exacte id die Fireworks toont en voeg er het voorvoegsel fireworks/ aan toe. Dynamische resolutie kloont de Fire Pass-template (tekst + 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 alleen tekst, tenzij je een aangepaste modelvermelding met afbeeldingsinvoer configureert.
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
Elke Fireworks-model-ref 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
  • Direct model: fireworks/accounts/fireworks/models/<model-name>
OpenClaw verwijdert het voorvoegsel fireworks/ bij het construeren van de API-aanvraag en stuurt het resterende pad naar het Fireworks-eindpunt als het OpenAI-compatibele model-veld.
Fireworks K2.6 retourneert een 400 als de aanvraag reasoning_*-parameters bevat, ook al ondersteunt Kimi thinking via Moonshots eigen API. Het providerbeleid (extensions/fireworks/thinking-policy.ts) adverteert alleen het off-thinkingniveau voor Kimi-model-id’s, zodat handmatige /think-schakelingen en providerbeleidoppervlakken afgestemd blijven op het runtimecontract.Configureer de Moonshot-provider en routeer hetzelfde model via die provider om Kimi-reasoning end-to-end te gebruiken.
Als de Gateway als beheerde service draait (launchd, systemd, Docker), moet de Fireworks-sleutel zichtbaar zijn voor dat proces, niet alleen voor je interactieve shell.
Een sleutel die alleen in een interactieve shell is geëxporteerd, helpt een launchd- of systemd-daemon niet, tenzij die omgeving daar ook wordt geïmporteerd. Stel de sleutel in ~/.openclaw/.env in of via env.shellEnv om hem leesbaar te maken vanuit het gatewayproces.
Op macOS koppelt openclaw gateway install ~/.openclaw/.env al aan het LaunchAgent-omgevingsbestand. Voer install opnieuw uit (of openclaw doctor --fix) nadat je de sleutel hebt geroteerd.

Gerelateerd

Modelproviders

Providers, model-refs en failovergedrag kiezen.

Thinking-modi

/think-niveaus, providerbeleid en routering van reasoning-geschikte modellen.

Moonshot

Voer Kimi uit met native thinking-uitvoer via Moonshots eigen API.

Probleemoplossing

Algemene probleemoplossing en veelgestelde vragen.