Hugging Face (inférence)

OpenClaw découvre les modèles avec :

GET https://router.huggingface.co/v1/modelsAuthorization: Bearer $HUGGINGFACE_HUB_TOKEN   # or $HF_TOKEN

La réponse suit le format d’OpenAI : { "object": "list", "data": [ { "id": "Qwen/Qwen3-8B", "owned_by": "Qwen", ... }, ... ] }.

Lorsqu’une clé est configurée (pendant l’intégration, via HUGGINGFACE_HUB_TOKEN ou via HF_TOKEN), la liste déroulante Modèle Hugging Face par défaut de la configuration interactive est alimentée à partir de ce point de terminaison. Au démarrage, le Gateway répète le même appel pour actualiser le catalogue. Les modèles découverts sont fusionnés avec le catalogue intégré ci-dessus, qui fournit notamment les métadonnées telles que la fenêtre de contexte et le coût lorsqu’un identifiant correspond. Si la requête échoue, ne renvoie aucune donnée ou qu’aucune clé n’est définie, OpenClaw utilise uniquement le catalogue intégré.

Désactivez la découverte sans supprimer le fournisseur :

openclaw config set plugins.entries.huggingface.config.discovery.enabled false

• Nom provenant de l’API : les modèles découverts utilisent la valeur name, title ou display_name de l’API lorsqu’elle est présente ; sinon, OpenClaw déduit un nom de l’identifiant du modèle (par exemple, deepseek-ai/DeepSeek-R1 devient « DeepSeek R1 »).
• Remplacement du nom d’affichage : définissez un libellé personnalisé pour chaque modèle dans la configuration :

{  agents: {    defaults: {      models: {        "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1 (fast)" },        "huggingface/deepseek-ai/DeepSeek-R1:cheapest": { alias: "DeepSeek R1 (cheap)" },      },    },  },}

• Suffixes de stratégie : :fastest et :cheapest sont des conventions du routeur de HF, et non des valeurs réécrites par OpenClaw : le suffixe est envoyé tel quel dans l’identifiant du modèle, puis le routeur de HF sélectionne le fournisseur d’inférence correspondant. Ajoutez chaque variante comme entrée distincte sous models.providers.huggingface.models (ou dans model.primary) si vous souhaitez un alias différent pour chaque suffixe.
• Fusion de la configuration : les entrées existantes dans models.providers.huggingface.models (par exemple dans models.json) sont conservées lors de la fusion de la configuration. Tout name, alias ou toute option de modèle personnalisée que vous y définissez persiste donc après les redémarrages.

Si le Gateway s’exécute comme un démon (launchd/systemd), assurez-vous que HUGGINGFACE_HUB_TOKEN ou HF_TOKEN est accessible à ce processus (par exemple dans ~/.openclaw/.env ou via env.shellEnv).