Passer au contenu principal
Fireworks expose des modèles open-weight et routés via une API compatible OpenAI. Installez le plugin fournisseur Fireworks officiel pour utiliser deux modèles Kimi pré-catalogués ainsi que n’importe quel modèle ou identifiant de routeur Fireworks à l’exécution.
PropriétéValeur
Identifiant fournisseurfireworks (alias : fireworks-ai)
Package@openclaw/fireworks-provider
Variable d’env authFIREWORKS_API_KEY
Option d’onboarding--auth-choice fireworks-api-key
Option CLI directe--fireworks-api-key <key>
APIcompatible OpenAI (openai-completions)
URL de basehttps://api.fireworks.ai/inference/v1
Modèle par défautfireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Alias par défautKimi K2.5 Turbo

Premiers pas

1

Installer le plugin

openclaw plugins install @openclaw/fireworks-provider
2

Définir la clé API Fireworks

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-...
L’onboarding enregistre la clé pour le fournisseur fireworks dans vos profils d’authentification et définit le routeur Kimi K2.5 Turbo Fire Pass comme modèle par défaut.
3

Vérifier que le modèle est disponible

openclaw models list --provider fireworks
La liste doit inclure Kimi K2.6 et Kimi K2.5 Turbo (Fire Pass). Si FIREWORKS_API_KEY n’est pas résolue, openclaw models status --json signale l’identifiant manquant sous auth.unusableProfiles.

Configuration non interactive

Pour les installations scriptées ou CI, transmettez tout sur la ligne de commande :
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice fireworks-api-key \
  --fireworks-api-key "$FIREWORKS_API_KEY" \
  --skip-health \
  --accept-risk

Catalogue intégré

Référence du modèleNomEntréeContexteSortie maxThinking
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6texte + image262,144262,144Désactivé de force
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)texte + image256,000256,000Désactivé de force (défaut)
OpenClaw fixe tous les modèles Kimi Fireworks sur thinking: off parce que Fireworks rejette les paramètres de thinking Kimi en production. Router le même modèle directement via Moonshot préserve la sortie de raisonnement Kimi. Consultez les modes de thinking pour basculer entre fournisseurs.

Identifiants de modèles Fireworks personnalisés

OpenClaw accepte n’importe quel modèle ou identifiant de routeur Fireworks à l’exécution. Utilisez l’identifiant exact affiché par Fireworks et préfixez-le avec fireworks/. La résolution dynamique clone le modèle Fire Pass (entrée texte + image, API compatible OpenAI, coût par défaut nul) et désactive automatiquement le thinking lorsque l’identifiant correspond au motif Kimi. Les identifiants dynamiques GLM sont marqués texte uniquement, sauf si vous configurez une entrée de modèle personnalisée avec une entrée image.
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
Chaque référence de modèle Fireworks dans OpenClaw commence par fireworks/, suivi de l’identifiant exact ou du chemin de routeur de la plateforme Fireworks. Par exemple :
  • Modèle routeur : fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
  • Modèle direct : fireworks/accounts/fireworks/models/<model-name>
OpenClaw supprime le préfixe fireworks/ lors de la construction de la requête API et envoie le chemin restant au point de terminaison Fireworks comme champ model compatible OpenAI.
Fireworks K2.6 renvoie une erreur 400 si la requête contient des paramètres reasoning_*, même si Kimi prend en charge le thinking via l’API propre à Moonshot. La stratégie du fournisseur (extensions/fireworks/thinking-policy.ts) annonce uniquement le niveau de thinking off pour les identifiants de modèles Kimi, afin que les bascules manuelles /think et les surfaces de stratégie fournisseur restent alignées avec le contrat d’exécution.Pour utiliser le raisonnement Kimi de bout en bout, configurez le fournisseur Moonshot et routez le même modèle via celui-ci.
Si le Gateway s’exécute comme service géré (launchd, systemd, Docker), la clé Fireworks doit être visible par ce processus, et pas seulement par votre shell interactif.
Une clé exportée uniquement dans un shell interactif n’aidera pas un démon launchd ou systemd, sauf si cet environnement y est également importé. Définissez la clé dans ~/.openclaw/.env ou via env.shellEnv pour la rendre lisible depuis le processus gateway.
Sous macOS, openclaw gateway install raccorde déjà ~/.openclaw/.env au fichier d’environnement LaunchAgent. Relancez l’installation (ou openclaw doctor --fix) après la rotation de la clé.

Liens associés

Fournisseurs de modèles

Choix des fournisseurs, références de modèles et comportement de bascule.

Modes de thinking

Niveaux /think, stratégies de fournisseurs et routage des modèles capables de raisonnement.

Moonshot

Exécutez Kimi avec une sortie de thinking native via l’API propre à Moonshot.

Dépannage

Dépannage général et FAQ.