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 provider ufficiale di Fireworks per usare due modelli Kimi già inclusi nel catalogo e qualsiasi modello o id router di Fireworks durante l'esecuzione.

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

Per iniziare

  • Installa il Plugin

    bash
    openclaw plugins install @openclaw/fireworks-provider

  • Imposta la chiave API di Fireworks

    Configurazione iniziale
    openclaw onboard --auth-choice fireworks-api-key
    Flag diretto
    openclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"
    Solo variabile di ambiente
    export FIREWORKS_API_KEY=fw-...

    La configurazione iniziale memorizza la chiave per il provider fireworks nei profili di autenticazione e imposta il router Kimi K2.5 Turbo Fire Pass come modello predefinito.

  • Verifica che il modello sia disponibile

    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 risolta, openclaw models status --json segnala la credenziale mancante in auth.unusableProfiles.

    • Configurazione non interattiva

    Per le installazioni tramite script o CI, passa tutti i parametri 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

    Riferimento del modello Nome Input Contesto Output massimo Ragionamento
    fireworks/accounts/fireworks/models/kimi-k2p6 Kimi K2.6 testo + immagine 262.144 262.144 Disattivato obbligatoriamente
    fireworks/accounts/fireworks/routers/kimi-k2p5-turbo Kimi K2.5 Turbo (Fire Pass) testo + immagine 256.000 256.000 Disattivato obbligatoriamente (predefinito)

    Id di modelli Fireworks personalizzati

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

    json5
    {  agents: {    defaults: {      model: {        primary: "fireworks/accounts/fireworks/models/<your-model-id>",      },    },  },}
    Funzionamento del prefisso degli id dei modelli

    Ogni riferimento a un modello Fireworks in OpenClaw inizia con fireworks/, seguito dall'id esatto o dal percorso del router nella piattaforma Fireworks. Ad esempio:

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

    OpenClaw rimuove il prefisso fireworks/ durante la costruzione della richiesta API e invia il percorso rimanente all'endpoint Fireworks come campo model compatibile con OpenAI.

    Perché il ragionamento viene disattivato obbligatoriamente per Kimi

    Fireworks fornisce Kimi senza un canale di ragionamento separato, pertanto la catena di pensiero può apparire nel flusso content visibile. In ogni richiesta Kimi di Fireworks, OpenClaw invia thinking: { type: "disabled" } e rimuove reasoning, reasoning_effort e reasoningEffort dal payload (extensions/fireworks/stream.ts). La policy del provider (extensions/fireworks/thinking-policy.ts) espone solo il livello di ragionamento off per gli id dei modelli Kimi, affinché i cambi manuali tramite /think e le interfacce della policy del provider rimangano coerenti con il contratto di runtime.

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

    Disponibilità dell'ambiente per il daemon

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

    OpenClaw carica ~/.openclaw/.env insieme alla configurazione, quindi le chiavi memorizzate in tale file raggiungono i servizi Gateway gestiti su ogni piattaforma. Riavvia il Gateway (oppure esegui nuovamente openclaw doctor --fix) dopo aver sostituito la chiave.

    Contenuti correlati

    Provider di modelli

    Scelta dei provider, dei riferimenti ai modelli e del comportamento di failover.
    Modalità di ragionamento

    Livelli di /think, policy dei provider e instradamento dei modelli con capacità di ragionamento.
    Moonshot

    Esegui Kimi con l'output di ragionamento nativo tramite l'API di Moonshot.
    Risoluzione dei problemi

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

    On this page