Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Fireworks stellt Open-Weight- und geroutete Modelle über eine OpenAI-kompatible API bereit. OpenClaw enthält ein gebündeltes Fireworks-Provider-Plugin, das mit zwei vorkatalogisierten Kimi-Modellen ausgeliefert wird und zur Laufzeit jede Fireworks-Modell- oder Router-ID akzeptiert.
EigenschaftWert
Provider-IDfireworks (Alias: fireworks-ai)
Plugingebündelt, enabledByDefault: true
Auth-Env-VarFIREWORKS_API_KEY
Einrichtungs-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

Fireworks-API-Schlüssel festlegen

openclaw onboard --auth-choice fireworks-api-key
Die Einrichtung speichert den Schlüssel für den fireworks-Provider in Ihren Auth-Profilen und legt den Fire Pass-Router Kimi K2.5 Turbo als Standardmodell fest.
2

Verfügbarkeit des Modells prüfen

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 wird, meldet openclaw models status --json die fehlenden Zugangsdaten unter auth.unusableProfiles.

​
Nicht interaktive Einrichtung

Für skriptgesteuerte 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

ModellreferenzNameEingabeKontextMaximale AusgabeDenken
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6Text + Bild262,144262,144Erzwungen deaktiviert
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)Text + Bild256,000256,000Erzwungen deaktiviert (Standard)
OpenClaw setzt alle Fireworks-Kimi-Modelle auf thinking: off, weil Fireworks Kimi-Denkparameter in der Produktion ablehnt. Wenn dasselbe Modell direkt über Moonshot geroutet wird, bleibt die Kimi-Reasoning-Ausgabe erhalten. Informationen zum Wechseln zwischen Providern finden Sie unter Denkmodi.

​
Benutzerdefinierte Fireworks-Modell-IDs

OpenClaw akzeptiert zur Laufzeit jede Fireworks-Modell- oder Router-ID. Verwenden Sie die exakte von Fireworks angezeigte ID und stellen Sie ihr fireworks/ voran. Die dynamische Auflösung klont die Fire-Pass-Vorlage (Text- und Bildeingabe, OpenAI-kompatible API, Standardkosten null) und deaktiviert das Denken automatisch, wenn die ID dem Kimi-Muster entspricht. 
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
Jede Fireworks-Modellreferenz in OpenClaw beginnt mit fireworks/, gefolgt von der exakten ID oder dem Router-Pfad von der Fireworks-Plattform. Beispiel:
  • 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.
Fireworks K2.6 gibt einen 400-Fehler zurück, wenn die Anfrage reasoning_*-Parameter enthält, obwohl Kimi Denken über Moonshots eigene API unterstützt. Die gebündelte Richtlinie (extensions/fireworks/thinking-policy.ts) weist für Kimi-Modell-IDs nur die Denklstufe off aus, sodass manuelle /think-Wechsel und Provider-Richtlinienoberflächen mit dem Laufzeitvertrag abgestimmt bleiben.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 läuft (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 ~/.profile steht, hilft einem launchd- oder systemd-Daemon nicht, es sei denn, diese Umgebung wird auch dort importiert. 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, Modellreferenzen und Failover-Verhalten auswählen.

Denkmodi

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

Moonshot

Führen Sie Kimi mit nativer Denkausgabe über Moonshots eigene API aus.

Fehlerbehebung

Allgemeine Fehlerbehebung und FAQ.