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

Providers

Feux d’artifice

Fireworks expose des modèles à poids ouverts et routés via une API compatible avec OpenAI. Installez le Plugin fournisseur officiel Fireworks 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 du fournisseur fireworks (alias : fireworks-ai)
Paquet @openclaw/fireworks-provider
Variable d’environnement d’authentification FIREWORKS_API_KEY
Option d’intégration --auth-choice fireworks-api-key
Option CLI directe --fireworks-api-key <key>
API Compatible avec 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

Prise en main

  • Installer le Plugin

    bash
    openclaw plugins install @openclaw/fireworks-provider

  • Définir la clé API Fireworks

    Intégration
    openclaw onboard --auth-choice fireworks-api-key
    Option directe
    openclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"
    Environnement uniquement
    export FIREWORKS_API_KEY=fw-...

    L’intégration 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 d’authentification manquant sous auth.unusableProfiles.

    • Configuration non interactive

    Pour les installations automatisées ou dans un environnement CI, transmettez tous les paramètres 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 maximale Réflexion
    fireworks/accounts/fireworks/models/kimi-k2p6 Kimi K2.6 texte + image 262,144 262,144 Désactivée de force
    fireworks/accounts/fireworks/routers/kimi-k2p5-turbo Kimi K2.5 Turbo (Fire Pass) texte + image 256,000 256,000 Désactivée de force (défaut)

    Identifiants de modèles Fireworks personnalisés

    OpenClaw accepte n’importe quel identifiant de modèle ou de routeur Fireworks à l’exécution. Utilisez l’identifiant exact affiché par Fireworks et préfixez-le par fireworks/. La résolution dynamique clone le modèle Fire Pass (entrée texte + image, API compatible avec OpenAI, coût par défaut nul) et désactive automatiquement la réflexion lorsque l’identifiant correspond au motif Kimi. Les identifiants dynamiques GLM sont marqués comme limités au texte, sauf si vous configurez une entrée de modèle personnalisée acceptant les images.

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

    Dans OpenClaw, chaque référence de modèle Fireworks commence par fireworks/, suivi de l’identifiant exact ou du chemin de routeur provenant 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 retire le préfixe fireworks/ lors de la construction de la requête API et envoie le chemin restant au point de terminaison Fireworks dans le champ model compatible avec OpenAI.

    Pourquoi la réflexion est désactivée de force pour Kimi

    Fireworks fournit Kimi sans canal de raisonnement distinct ; la chaîne de raisonnement peut donc apparaître dans le flux content visible. Pour chaque requête Kimi sur Fireworks, OpenClaw envoie thinking: { type: "disabled" } et retire reasoning, reasoning_effort et reasoningEffort de la charge utile (extensions/fireworks/stream.ts). La politique du fournisseur (extensions/fireworks/thinking-policy.ts) n’annonce que le niveau de réflexion off pour les identifiants de modèles Kimi, de sorte que les changements manuels via /think et les surfaces de politique du fournisseur restent alignés sur le contrat d’exécution.

    Pour utiliser le raisonnement de Kimi de bout en bout, configurez le fournisseur Moonshot et acheminez le même modèle par son intermédiaire.

    Disponibilité de l’environnement pour le démon

    Si le Gateway s’exécute en tant que service géré (launchd, systemd, Docker), la clé Fireworks doit être visible par ce processus, et pas seulement par votre shell interactif.

    OpenClaw charge ~/.openclaw/.env lors du chargement de la configuration ; les clés qui y sont stockées sont donc accessibles aux services Gateway gérés sur toutes les plateformes. Redémarrez le Gateway (ou exécutez de nouveau openclaw doctor --fix) après la rotation de la clé.

    Ressources associées

    Fournisseurs de modèles

    Choix des fournisseurs, des références de modèles et du comportement de basculement.
    Modes de réflexion

    Niveaux de /think, politiques des fournisseurs et routage des modèles capables de raisonner.
    Moonshot

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

    Dépannage général et FAQ.
    Was this useful?
    On this page

    On this page