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

Providers

Fuochi d'artificio

Fireworks espone modelli open-weight e instradati tramite un'API compatibile con OpenAI. Installa il plugin ufficiale del provider Fireworks per usare due modelli Kimi pre-catalogati e qualsiasi modello Fireworks o id di router in fase di esecuzione.

Proprietà Valore
Id provider fireworks (alias: fireworks-ai)
Pacchetto @openclaw/fireworks-provider
Variabile env auth FIREWORKS_API_KEY
Flag di onboarding --auth-choice fireworks-api-key
Flag CLI diretto --fireworks-api-key <key>
API compatibile con OpenAI (openai-completions)
URL base https://api.fireworks.ai/inference/v1
Modello predefinito fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Alias predefinito Kimi K2.5 Turbo

Per iniziare

  • Install the plugin

    bash
    openclaw plugins install @openclaw/fireworks-provider

  • Set the Fireworks API key

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

    L'onboarding archivia la chiave associandola al provider fireworks nei tuoi profili di autenticazione e imposta il router Kimi K2.5 Turbo Fire Pass come modello predefinito.

  • Verify the model is available

    bash
    openclaw models list --provider fireworks

    L'elenco dovrebbe includere Kimi K2.6 e Kimi K2.5 Turbo (Fire Pass). Se FIREWORKS_API_KEY non viene risolto, openclaw models status --json segnala la credenziale mancante in auth.unusableProfiles.

    • Configurazione non interattiva

    Per installazioni con script o CI, passa tutto dalla riga di comando:

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

    Catalogo integrato

    Rif. modello Nome Input Contesto Output max Thinking
    fireworks/accounts/fireworks/models/kimi-k2p6 Kimi K2.6 testo + immagine 262,144 262,144 Disattivato forzatamente
    fireworks/accounts/fireworks/routers/kimi-k2p5-turbo Kimi K2.5 Turbo (Fire Pass) testo + immagine 256,000 256,000 Disattivato forzatamente (predefinito)

    Id modello Fireworks personalizzati

    OpenClaw accetta qualsiasi modello Fireworks o id di router in fase di esecuzione. Usa l'id esatto mostrato da Fireworks e anteponi fireworks/. La risoluzione dinamica clona il template Fire Pass (input testo + immagine, API compatibile con OpenAI, costo predefinito zero) e disabilita automaticamente il thinking quando l'id corrisponde al pattern Kimi. Gli id dinamici GLM sono contrassegnati come solo testo, a meno che tu non configuri una voce modello personalizzata con input immagine.

    json5
    {  agents: {    defaults: {      model: {        primary: "fireworks/accounts/fireworks/models/<your-model-id>",      },    },  },}
    How model id prefixing works

    Ogni riferimento modello Fireworks in OpenClaw inizia con fireworks/, seguito dall'id esatto o dal percorso router della piattaforma Fireworks. Per esempio:

    • Modello router: fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
    • Modello diretto: fireworks/accounts/fireworks/models/<model-name>

    OpenClaw rimuove il prefisso fireworks/ quando costruisce la richiesta API e invia il percorso restante all'endpoint Fireworks come campo model compatibile con OpenAI.

    Why thinking is forced off for Kimi

    Fireworks K2.6 restituisce un 400 se la richiesta contiene parametri reasoning_*, anche se Kimi supporta il thinking tramite l'API proprietaria di Moonshot. La policy del provider (extensions/fireworks/thinking-policy.ts) pubblicizza solo il livello di thinking off per gli id modello Kimi, quindi gli switch manuali /think e le superfici di policy del provider restano allineati al contratto di runtime.

    Per usare il ragionamento Kimi end-to-end, configura il provider Moonshot e instrada lo stesso modello tramite quello.

    Environment availability for the daemon

    Se il Gateway viene eseguito come servizio gestito (launchd, systemd, Docker), la chiave Fireworks deve essere visibile a quel processo, non solo alla tua shell interattiva.

    Su macOS, openclaw gateway install collega già ~/.openclaw/.env al file di ambiente del LaunchAgent. Riesegui l'installazione (o openclaw doctor --fix) dopo aver ruotato la chiave.

    Correlati

    Model providers

    Scelta di provider, riferimenti modello e comportamento di failover.
    Thinking modes

    Livelli /think, policy dei provider e instradamento di modelli capaci di ragionamento.
    Moonshot

    Esegui Kimi con output di thinking nativo tramite l'API proprietaria di Moonshot.
    Troubleshooting

    Risoluzione dei problemi generale e FAQ.
    Was this useful?
    On this page

    On this page