Zum Hauptinhalt springen
Fireworks stellt Open-Weight-Modelle und geroutete Modelle über eine OpenAI-kompatible API bereit. Installieren Sie das offizielle Fireworks-Provider-Plugin, um zwei vorkatalogisierte Kimi-Modelle und jede Fireworks-Modell- oder Router-ID zur Laufzeit zu verwenden.
EigenschaftWert
Provider-IDfireworks (Alias: fireworks-ai)
Paket@openclaw/fireworks-provider
Auth-UmgebungsvariableFIREWORKS_API_KEY
Onboarding-Flag--auth-choice fireworks-api-key
Direktes CLI-Flag--fireworks-api-key <key>
APIOpenAI-kompatibel (openai-completions)
Basis-URLhttps://api.fireworks.ai/inference/v1
Standardmodellfireworks/accounts/fireworks/routers/kimi-k2p5-turbo
StandardaliasKimi K2.5 Turbo

​
Erste Schritte

1

Plugin installieren

openclaw plugins install @openclaw/fireworks-provider
2

Fireworks-API-Schlüssel festlegen

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-...
Das Onboarding speichert den Schlüssel für den fireworks-Provider in Ihren Auth-Profilen und legt den Fire Pass Kimi K2.5 Turbo Router als Standardmodell fest.
3

Prüfen, ob das Modell verfügbar ist

openclaw models list --provider fireworks
Die Liste sollte Kimi K2.6 und Kimi K2.5 Turbo (Fire Pass) enthalten. Wenn FIREWORKS_API_KEY nicht aufgelöst werden kann, meldet openclaw models status --json die fehlende Anmeldeinformation unter auth.unusableProfiles.

​
Nicht interaktive Einrichtung

Für skriptgesteuerte Installationen oder CI-Installationen übergeben Sie alles über die Befehlszeile: 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY" \
  --skip-health \
  --accept-risk

​
Integrierter Katalog

Modell-RefNameEingabeKontextMax. AusgabeThinking
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6Text + Bild262,144262,144Erzwungen aus
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)Text + Bild256,000256,000Erzwungen aus (Standard)
OpenClaw setzt alle Fireworks-Kimi-Modelle fest auf thinking: off, weil Fireworks Kimi-Thinking-Parameter in Produktion ablehnt. Wenn Sie dasselbe Modell direkt über Moonshot routen, bleibt die Kimi-Reasoning-Ausgabe erhalten. Siehe Thinking-Modi zum Wechseln zwischen Providern.

​
Benutzerdefinierte Fireworks-Modell-IDs

OpenClaw akzeptiert zur Laufzeit jede Fireworks-Modell- oder Router-ID. Verwenden Sie die exakte ID, die Fireworks anzeigt, und stellen Sie ihr fireworks/ voran. Die dynamische Auflösung klont die Fire-Pass-Vorlage (Text- + Bildeingabe, OpenAI-kompatible API, Standardkosten null) und deaktiviert Thinking automatisch, wenn die ID dem Kimi-Muster entspricht. Dynamische GLM-IDs werden als reine Textmodelle markiert, sofern Sie keinen benutzerdefinierten Modelleintrag mit Bildeingabe konfigurieren. 
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
Jede Fireworks-Modell-Ref in OpenClaw beginnt mit fireworks/, gefolgt von der exakten ID oder dem Router-Pfad aus der Fireworks-Plattform. Zum Beispiel:
  • Router-Modell: fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
  • Direktes Modell: fireworks/accounts/fireworks/models/<model-name>
OpenClaw entfernt das Präfix fireworks/ beim Erstellen der API-Anfrage und sendet den verbleibenden Pfad als OpenAI-kompatibles Feld model an den Fireworks-Endpunkt.
Fireworks K2.6 gibt einen 400-Fehler zurück, wenn die Anfrage reasoning_*-Parameter enthält, obwohl Kimi Thinking über Moonshots eigene API unterstützt. Die Provider-Richtlinie (extensions/fireworks/thinking-policy.ts) bewirbt für Kimi-Modell-IDs nur die Thinking-Stufe off, damit manuelle /think-Wechsel und Provider-Richtlinienoberflächen mit dem Laufzeitvertrag übereinstimmen.Um Kimi-Reasoning durchgängig zu verwenden, konfigurieren Sie den Moonshot-Provider und routen Sie dasselbe Modell darüber.
Wenn der Gateway als verwalteter Dienst ausgeführt wird (launchd, systemd, Docker), muss der Fireworks-Schlüssel für diesen Prozess sichtbar sein — nicht nur für Ihre interaktive Shell.
Ein Schlüssel, der nur in einer interaktiven Shell exportiert wurde, hilft einem launchd- oder systemd-Daemon nicht, sofern diese Umgebung dort nicht ebenfalls importiert wird. Legen Sie den Schlüssel in ~/.openclaw/.env oder über env.shellEnv fest, damit er vom Gateway-Prozess gelesen werden kann.
Unter macOS bindet openclaw gateway install ~/.openclaw/.env bereits in die LaunchAgent-Umgebungsdatei ein. Führen Sie die Installation nach dem Rotieren des Schlüssels erneut aus (oder openclaw doctor --fix).

​
Verwandte Themen

Modell-Provider

Provider, Modell-Refs und Failover-Verhalten auswählen.

Thinking-Modi

/think-Stufen, Provider-Richtlinien und das Routing von reasoning-fähigen Modellen.

Moonshot

Führen Sie Kimi mit nativer Thinking-Ausgabe über Moonshots eigene API aus.

Problembehandlung

Allgemeine Problembehandlung und FAQ.