Providers

Fireworks

Fireworks stellt Modelle mit offenen Gewichten und geroutete Modelle über eine OpenAI-kompatible API bereit. Installieren Sie das offizielle Fireworks-Provider-Plugin, um zwei vorkatalogisierte Kimi-Modelle sowie beliebige Fireworks-Modell- oder Router-IDs zur Laufzeit zu verwenden.

Eigenschaft Wert
Provider-ID fireworks (Alias: fireworks-ai)
Paket @openclaw/fireworks-provider
Umgebungsvariable zur Authentifizierung FIREWORKS_API_KEY
Onboarding-Flag --auth-choice fireworks-api-key
Direktes CLI-Flag --fireworks-api-key <key>
API OpenAI-kompatibel (openai-completions)
Basis-URL https://api.fireworks.ai/inference/v1
Standardmodell fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Standardalias Kimi K2.5 Turbo

Erste Schritte

  • Plugin installieren

    bash
    openclaw plugins install @openclaw/fireworks-provider
  • Fireworks-API-Schlüssel festlegen

    Onboarding
    openclaw onboard --auth-choice fireworks-api-key
    Direktes Flag
    openclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"
    Nur Umgebungsvariable
    export FIREWORKS_API_KEY=fw-...

    Das Onboarding speichert den Schlüssel für den Provider fireworks in Ihren Authentifizierungsprofilen und legt den Kimi-K2.5-Turbo-Router Fire Pass als Standardmodell fest.

  • Verfügbarkeit des Modells überprüfen

    bash
    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 fehlenden Anmeldedaten unter auth.unusableProfiles.

  • Nicht interaktive Einrichtung

    Übergeben Sie bei skriptgesteuerten oder CI-Installationen alle Angaben über die Befehlszeile:

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

    Integrierter Katalog

    Modellreferenz Name Eingabe Kontext Maximale Ausgabe Denkmodus
    fireworks/accounts/fireworks/models/kimi-k2p6 Kimi K2.6 Text + Bild 262,144 262,144 Erzwungen deaktiviert
    fireworks/accounts/fireworks/routers/kimi-k2p5-turbo Kimi K2.5 Turbo (Fire Pass) Text + Bild 256,000 256,000 Erzwungen deaktiviert (Standard)

    Benutzerdefinierte Fireworks-Modell-IDs

    OpenClaw akzeptiert zur Laufzeit beliebige Fireworks-Modell- oder Router-IDs. Verwenden Sie die von Fireworks angezeigte exakte ID und stellen Sie ihr fireworks/ voran. Die dynamische Auflösung kopiert die Fire-Pass-Vorlage (Text- und Bildeingabe, OpenAI-kompatible API, standardmäßig keine Kosten) und deaktiviert den Denkmodus automatisch, wenn die ID dem Kimi-Muster entspricht. Dynamische GLM-IDs werden als reine Textmodelle gekennzeichnet, sofern Sie keinen benutzerdefinierten Modelleintrag mit Bildeingabe konfigurieren.

    json5
    {  agents: {    defaults: {      model: {        primary: "fireworks/accounts/fireworks/models/<your-model-id>",      },    },  },}
    Funktionsweise des Modell-ID-Präfixes

    Jede Fireworks-Modellreferenz in OpenClaw beginnt mit fireworks/, gefolgt von der exakten ID oder dem Router-Pfad der Fireworks-Plattform. Beispiele:

    • Router-Modell: fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
    • Direktes Modell: fireworks/accounts/fireworks/models/<model-name>

    OpenClaw entfernt beim Erstellen der API-Anfrage das Präfix fireworks/ und sendet den verbleibenden Pfad als OpenAI-kompatibles Feld model an den Fireworks-Endpunkt.

    Warum der Denkmodus für Kimi erzwungen deaktiviert wird

    Fireworks stellt Kimi ohne separaten Reasoning-Kanal bereit, sodass Gedankengänge im sichtbaren content-Stream erscheinen können. Bei jeder Fireworks-Kimi-Anfrage sendet OpenClaw thinking: { type: "disabled" } und entfernt reasoning, reasoning_effort sowie reasoningEffort aus der Nutzlast (extensions/fireworks/stream.ts). Die Provider-Richtlinie (extensions/fireworks/thinking-policy.ts) gibt für Kimi-Modell-IDs ausschließlich die Denkstufe off an. Dadurch bleiben manuelle /think-Wechsel und die Oberflächen für Provider-Richtlinien mit dem Laufzeitvertrag abgestimmt.

    Um Kimi-Reasoning durchgängig zu verwenden, konfigurieren Sie den Moonshot-Provider und routen Sie dasselbe Modell darüber.

    Verfügbarkeit der Umgebung für den Daemon

    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.

    OpenClaw lädt ~/.openclaw/.env beim Laden der Konfiguration. Daher erreichen dort gespeicherte Schlüssel verwaltete Gateway-Dienste auf jeder Plattform. Starten Sie den Gateway nach dem Austausch des Schlüssels neu oder führen Sie openclaw doctor --fix erneut aus.

    Verwandte Themen

    Was this useful?
    On this page

    On this page