Vai al contenuto principale
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 providerfireworks (alias: fireworks-ai)
Pacchetto@openclaw/fireworks-provider
Variabile env authFIREWORKS_API_KEY
Flag di onboarding--auth-choice fireworks-api-key
Flag CLI diretto--fireworks-api-key <key>
APIcompatibile con OpenAI (openai-completions)
URL basehttps://api.fireworks.ai/inference/v1
Modello predefinitofireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Alias predefinitoKimi K2.5 Turbo

​
Per iniziare

1

Install the plugin

openclaw plugins install @openclaw/fireworks-provider
2

Set the Fireworks API key

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

Verify the model is available

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: 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY" \
  --skip-health \
  --accept-risk

​
Catalogo integrato

Rif. modelloNomeInputContestoOutput maxThinking
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6testo + immagine262,144262,144Disattivato forzatamente
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)testo + immagine256,000256,000Disattivato forzatamente (predefinito)
OpenClaw forza tutti i modelli Kimi di Fireworks su thinking: off perché Fireworks rifiuta i parametri di thinking Kimi in produzione. L’instradamento dello stesso modello direttamente tramite Moonshot preserva l’output di ragionamento Kimi. Consulta le modalità di thinking per passare da un provider all’altro.

​
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. 
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
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.
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.
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.
Una chiave esportata solo in una shell interattiva non sarà utile a un daemon launchd o systemd, a meno che quell’ambiente non venga importato anche lì. Imposta la chiave in ~/.openclaw/.env o tramite env.shellEnv per renderla leggibile dal processo gateway.
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.