Providers

Fireworks

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

Eigenschaft Wert
Provider-ID fireworks (Alias: fireworks-ai)
Paket @openclaw/fireworks-provider
Umgebungsvariable für die Authentifizierung FIREWORKS_API_KEY
Onboarding-Flag --auth-choice fireworks-api-key
Direkter 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-k2p6-turbo
Standardalias Kimi K2.6 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
    Direkter 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.6-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.6 Turbo (Fire Pass) enthalten. Wenn FIREWORKS_API_KEY nicht aufgelöst wird, 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 Thinking
    fireworks/accounts/fireworks/models/kimi-k2p6 Kimi K2.6 Text + Bild 262,144 262,144 Erzwungen deaktiviert
    fireworks/accounts/fireworks/routers/kimi-k2p6-turbo Kimi K2.6 Turbo (Fire Pass) Text + Bild 256,000 256,000 Erzwungen deaktiviert (Standard)

    Benutzerdefinierte Fireworks-Modell-IDs

    OpenClaw akzeptiert zur Laufzeit jede beliebige Fireworks-Modell- oder Router-ID. Verwenden Sie die von Fireworks angezeigte exakte ID und stellen Sie ihr fireworks/ voran. Bei der dynamischen Auflösung wird die Fire-Pass-Vorlage geklont (Text- und Bildeingabe, OpenAI-kompatible API, Standardkosten null), und Thinking wird automatisch deaktiviert, 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 der Modell-ID-Präfixe

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

    • Router-Modell: fireworks/accounts/fireworks/routers/kimi-k2p6-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 Thinking 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 Thinking-Stufe off an, sodass manuelle /think-Umschaltungen 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.

    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, sodass dort gespeicherte Schlüssel auf jeder Plattform die verwalteten Gateway-Dienste erreichen. Starten Sie den Gateway neu (oder führen Sie openclaw doctor --fix erneut aus), nachdem Sie den Schlüssel rotiert haben.

    Verwandte Themen

    Was this useful?
    On this page

    On this page