Vai al contenuto principale

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 espone modelli open-weight e instradati tramite un’API compatibile con OpenAI. OpenClaw include un provider Plugin Fireworks in bundle fornito con due modelli Kimi pre-catalogati e accetta qualsiasi modello Fireworks o id router a runtime.
ProprietàValore
Id providerfireworks (alias: fireworks-ai)
Pluginin bundle, enabledByDefault: true
Var env authFIREWORKS_API_KEY
Flag 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

Imposta la chiave API Fireworks

openclaw onboard --auth-choice fireworks-api-key
L’onboarding memorizza la chiave per il provider fireworks nei tuoi profili di autenticazione e imposta il router Fire Pass Kimi K2.5 Turbo come modello predefinito.
2

Verifica che il modello sia disponibile

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 installazioni tramite 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,144Forzato su off
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)testo + immagine256,000256,000Forzato su off (predefinito)
OpenClaw imposta tutti i modelli Fireworks Kimi su thinking: off perché Fireworks rifiuta i parametri di thinking Kimi in produzione. Instradare lo stesso modello direttamente tramite Moonshot preserva l’output di ragionamento di Kimi. Consulta le modalità di thinking per passare da un provider all’altro.

​
Id modello Fireworks personalizzati

OpenClaw accetta qualsiasi modello Fireworks o id router a runtime. 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. 
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
Ogni riferimento a un 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 propria di Moonshot. La policy in bundle (extensions/fireworks/thinking-policy.ts) dichiara solo il livello di thinking off per gli id modello Kimi, così gli switch manuali /think e le superfici delle policy 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 esso.
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 presente solo in ~/.profile non aiuterà 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 del gateway.
Su macOS, openclaw gateway install collega già ~/.openclaw/.env al file ambiente del LaunchAgent. Riesegui l’installazione (o openclaw doctor --fix) dopo aver ruotato la chiave.

​
Correlati

Provider di modelli

Scelta dei provider, riferimenti ai modelli e comportamento di failover.

Modalità di thinking

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

Moonshot

Esegui Kimi con output di thinking nativo tramite l’API propria di Moonshot.

Risoluzione dei problemi

Risoluzione generale dei problemi e FAQ.