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

Providers

Chutes

Chutes expose des catalogues de modèles open source via une API compatible avec OpenAI. OpenClaw prend en charge l’authentification OAuth dans le navigateur et par clé API.

Propriété Valeur
Fournisseur chutes
Plugin paquet externe officiel (@openclaw/chutes-provider)
API compatible avec OpenAI
URL de base https://llm.chutes.ai/v1
Authentification OAuth ou clé API (voir ci-dessous)
Variables d’environnement d’exécution CHUTES_API_KEY, CHUTES_OAUTH_TOKEN

CHUTES_OAUTH_TOKEN fournit directement un jeton d’accès OAuth déjà obtenu (par exemple dans un environnement CI), sans passer par le flux interactif dans le navigateur décrit ci-dessous.

Installer le Plugin

bash
openclaw plugins install @openclaw/chutes-provideropenclaw gateway restart

Bien démarrer

Les deux méthodes définissent chutes/zai-org/GLM-4.7-TEE comme modèle par défaut et enregistrent le catalogue Chutes.

OAuth

  • Exécuter le flux d’intégration OAuth

    bash
    openclaw onboard --auth-choice chutes

    OpenClaw lance localement le flux dans le navigateur ou affiche une URL ainsi qu’un flux permettant de coller la redirection sur les hôtes distants ou sans interface graphique. Les jetons OAuth sont automatiquement actualisés par l’intermédiaire des profils d’authentification OpenClaw.

    • Clé API

  • Obtenir une clé API

    Créez une clé sur chutes.ai/settings/api-keys.

  • Exécuter le flux d’intégration par clé API

    bash
    openclaw onboard --auth-choice chutes-api-key

    • Comportement de la découverte

    Lorsque l’authentification Chutes est disponible, OpenClaw interroge GET /v1/models avec ces identifiants et utilise les modèles découverts, mis en cache pendant 5 minutes pour chaque identifiant. Si une clé a expiré ou n’est pas autorisée (HTTP 401), OpenClaw réessaie une fois sans identifiants. Si la découverte ne renvoie toujours aucune ligne, échoue ou renvoie tout autre statut hors de la plage 2xx, OpenClaw utilise à la place le catalogue statique intégré (la découverte par clé API et celle par OAuth suivent le même chemin). Si la découverte échoue au démarrage, le catalogue statique est utilisé automatiquement.

    Alias par défaut

    OpenClaw enregistre trois alias pratiques pour le catalogue Chutes :

    Alias Modèle cible
    chutes-fast chutes/zai-org/GLM-4.7-FP8
    chutes-pro chutes/deepseek-ai/DeepSeek-V3.2-TEE
    chutes-vision chutes/chutesai/Mistral-Small-3.2-24B-Instruct-2506

    Catalogue de démarrage intégré

    Le catalogue de secours intégré comprend 47 modèles. Voici un échantillon représentatif des références actuelles :

    Référence du modèle
    chutes/zai-org/GLM-4.7-TEE
    chutes/zai-org/GLM-5-TEE
    chutes/deepseek-ai/DeepSeek-V3.2-TEE
    chutes/deepseek-ai/DeepSeek-R1-0528-TEE
    chutes/moonshotai/Kimi-K2.5-TEE
    chutes/chutesai/Mistral-Small-3.2-24B-Instruct-2506
    chutes/Qwen/Qwen3-Coder-Next-TEE
    chutes/openai/gpt-oss-120b-TEE

    Exécutez openclaw models list --all --provider chutes pour afficher la liste complète.

    Exemple de configuration

    json5
    {  agents: {    defaults: {      model: { primary: "chutes/zai-org/GLM-4.7-TEE" },      models: {        "chutes/zai-org/GLM-4.7-TEE": { alias: "Chutes GLM 4.7" },        "chutes/deepseek-ai/DeepSeek-V3.2-TEE": { alias: "Chutes DeepSeek V3.2" },      },    },  },}
    Personnalisation d’OAuth

    Personnalisez le flux OAuth à l’aide de variables d’environnement facultatives :

    Variable Fonction
    CHUTES_CLIENT_ID Identifiant client OAuth (demandé s’il n’est pas défini)
    CHUTES_CLIENT_SECRET Secret client OAuth
    CHUTES_OAUTH_REDIRECT_URI URI de redirection (valeur par défaut : http://127.0.0.1:1456/oauth-callback)
    CHUTES_OAUTH_SCOPES Portées séparées par des espaces (valeur par défaut : openid profile chutes:invoke)

    Consultez la documentation OAuth de Chutes pour connaître les exigences relatives à l’application de redirection et obtenir de l’aide.

    Remarques
    • Les modèles Chutes sont enregistrés au format chutes/<model-id>.
    • Chutes ne communique pas l’utilisation des jetons pendant la diffusion en continu (supportsUsageInStreaming: false) ; les totaux d’utilisation s’affichent néanmoins une fois la diffusion terminée.

    Voir aussi

    Sélection du modèle

    Règles des fournisseurs, références de modèles et comportement de basculement.
    Référence de configuration

    Schéma de configuration complet, y compris les paramètres des fournisseurs.
    Chutes

    Tableau de bord Chutes et documentation de l’API.
    Clés API Chutes

    Créez et gérez les clés API Chutes.
    Was this useful?
    On this page

    On this page