Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Fireworks biedt open-weight en gerouteerde modellen via een OpenAI-compatibele API. OpenClaw bevat een gebundelde Fireworks-provider-Plugin met twee vooraf gecatalogiseerde Kimi-modellen en accepteert elke Fireworks-model- of router-id tijdens runtime.
EigenschapWaarde
Provider-idfireworks (alias: fireworks-ai)
Plugingebundeld, enabledByDefault: true
Auth-env-varFIREWORKS_API_KEY
Onboarding-vlag--auth-choice fireworks-api-key
Directe CLI-vlag--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

Set the Fireworks API key

openclaw onboard --auth-choice fireworks-api-key
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.
2

Verify the model is available

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 installatie

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

Ingebouwde catalogus

ModelrefNaamInvoerContextMax. uitvoerThinking
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6tekst + beeld262,144262,144Geforceerd uit
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)tekst + beeld256,000256,000Geforceerd uit (standaard)
OpenClaw pint alle Fireworks Kimi-modellen vast op thinking: off, omdat Fireworks Kimi-thinking-parameters in productie weigert. Door hetzelfde model rechtstreeks via Moonshot te routeren, blijft Kimi-reasoning-uitvoer behouden. Zie thinking-modi om tussen providers te schakelen.

Aangepaste Fireworks-model-id’s

OpenClaw accepteert elke Fireworks-model- of router-id tijdens runtime. Gebruik de exacte id die Fireworks toont en voeg het voorvoegsel fireworks/ toe. Dynamische resolutie kloont de Fire Pass-template (tekst- en beeldinvoer, OpenAI-compatibele API, standaardkosten nul) en schakelt thinking automatisch uit wanneer de id overeenkomt met het Kimi-patroon.
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
Elke Fireworks-modelref 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 samenstellen 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 gebundelde beleid (extensions/fireworks/thinking-policy.ts) adverteert alleen het thinking-niveau off voor Kimi-model-id’s, zodat handmatige /think-schakelaars en providerbeleidsoppervlakken afgestemd blijven op het runtimecontract.Om Kimi-reasoning end-to-end te gebruiken, configureer je de Moonshot-provider en routeer je hetzelfde model via die provider.
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 ~/.profile staat, helpt een launchd- of systemd-daemon niet tenzij die omgeving daar ook wordt geïmporteerd. Stel de sleutel in ~/.openclaw/.env of via env.shellEnv in om deze 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

Model providers

Providers, modelrefs en failovergedrag kiezen.

Thinking modes

/think-niveaus, providerbeleid en het routeren van modellen met reasoning-mogelijkheden.

Moonshot

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

Troubleshooting

Algemene probleemoplossing en FAQ.