Passer au contenu principal

Documentation Index

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

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

Fireworks expose des modèles à pondérations ouvertes et routés via une API compatible OpenAI. OpenClaw inclut un Plugin de fournisseur Fireworks groupé, livré avec deux modèles Kimi pré-catalogués, et accepte n’importe quel modèle Fireworks ou id de routeur Fireworks à l’exécution.
PropriétéValeur
Id du fournisseurfireworks (alias : fireworks-ai)
Plugingroupé, enabledByDefault: true
Variable d’env. authFIREWORKS_API_KEY
Option d’intégration--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

​
Bien démarrer

1

Définir la clé API Fireworks

openclaw onboard --auth-choice fireworks-api-key
L’intégration stocke la clé pour le fournisseur fireworks dans vos profils d’authentification et définit le routeur Fire Pass Kimi K2.5 Turbo comme modèle par défaut.
2

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ésolu, openclaw models status --json signale l’identifiant manquant sous auth.unusableProfiles.

​
Configuration non interactive

Pour les installations scriptées ou CI, passez 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. du modèleNomEntréeContexteSortie maxRéflexion
fireworks/accounts/fireworks/models/kimi-k2p6Kimi K2.6texte + image262,144262,144Désactivée de force
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)texte + image256,000256,000Désactivée de force (défaut)
OpenClaw fixe tous les modèles Kimi Fireworks à thinking: off, car Fireworks rejette les paramètres de réflexion Kimi en production. Router le même modèle directement via Moonshot préserve la sortie de raisonnement Kimi. Consultez les modes de réflexion pour basculer entre les fournisseurs.

​
Ids de modèles Fireworks personnalisés

OpenClaw accepte n’importe quel modèle Fireworks ou id de routeur Fireworks à l’exécution. Utilisez l’id 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 la réflexion lorsque l’id correspond au motif Kimi. 
{
  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’id exact ou du chemin de routeur issu de la plateforme Fireworks. Par exemple :
  • Modèle de 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 la réflexion via l’API propre à Moonshot. La stratégie groupée (extensions/fireworks/thinking-policy.ts) annonce uniquement le niveau de réflexion off pour les ids 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é présente uniquement dans ~/.profile 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.
Sur macOS, openclaw gateway install connecte déjà ~/.openclaw/.env au fichier d’environnement LaunchAgent. Réexécutez l’installation (ou openclaw doctor --fix) après la rotation de la clé.

​
Liens connexes

Fournisseurs de modèles

Choisir les fournisseurs, les références de modèles et le comportement de bascule.

Modes de réflexion

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

Moonshot

Exécuter Kimi avec une sortie de réflexion native via l’API propre à Moonshot.

Dépannage

Dépannage général et FAQ.