OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Fireworks

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 fournisseur fireworks (alias : fireworks-ai)
Package @openclaw/fireworks-provider
Variable d’env auth FIREWORKS_API_KEY
Option d’onboarding --auth-choice fireworks-api-key
Option CLI directe --fireworks-api-key <key>
API compatible OpenAI (openai-completions)
URL de base https://api.fireworks.ai/inference/v1
Modèle par défaut fireworks/accounts/fireworks/routers/kimi-k2p5-turbo
Alias par défaut Kimi K2.5 Turbo

Premiers pas

  • Installer le plugin

    bash
    openclaw plugins install @openclaw/fireworks-provider

  • Définir la clé API Fireworks

    Onboarding
    openclaw onboard --auth-choice fireworks-api-key
    Option directe
    openclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"
    Env uniquement
    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.

  • Vérifier que le modèle est disponible

    bash
    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 :

    bash
    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èle Nom Entrée Contexte Sortie max Thinking
    fireworks/accounts/fireworks/models/kimi-k2p6 Kimi K2.6 texte + image 262,144 262,144 Désactivé de force
    fireworks/accounts/fireworks/routers/kimi-k2p5-turbo Kimi K2.5 Turbo (Fire Pass) texte + image 256,000 256,000 Désactivé de force (défaut)

    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.

    json5
    {  agents: {    defaults: {      model: {        primary: "fireworks/accounts/fireworks/models/<your-model-id>",      },    },  },}
    Fonctionnement du préfixage des identifiants de modèle

    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.

    Pourquoi le thinking est désactivé de force pour Kimi

    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.

    Disponibilité de l’environnement pour le démon

    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.

    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.
    Was this useful?
    On this page

    On this page