Providers

Feuerwerk

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.

Eigenschaft Wert
Provider-ID fireworks (Alias: fireworks-ai)
Paket @openclaw/fireworks-provider
Auth-Umgebungsvariable 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 Env
    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.

  • Prüfen, ob das Modell verfügbar ist

    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 fehlende Anmeldeinformation unter auth.unusableProfiles.

  • Nicht interaktive Einrichtung

    Für skriptgesteuerte Installationen oder CI-Installationen übergeben Sie alles ü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

    Modell-Ref Name Eingabe Kontext Max. Ausgabe Thinking
    fireworks/accounts/fireworks/models/kimi-k2p6 Kimi K2.6 Text + Bild 262,144 262,144 Erzwungen aus
    fireworks/accounts/fireworks/routers/kimi-k2p5-turbo Kimi K2.5 Turbo (Fire Pass) Text + Bild 256,000 256,000 Erzwungen aus (Standard)

    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.

    json5
    {  agents: {    defaults: {      model: {        primary: "fireworks/accounts/fireworks/models/<your-model-id>",      },    },  },}
    So funktioniert das Präfix für Modell-IDs

    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.

    Warum Thinking für Kimi erzwungen ausgeschaltet ist

    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.

    Umgebungsverfügbarkeit 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.

    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

    Was this useful?
    On this page

    On this page