Hugging Face (inferentie)

Hugging Face Inference Providers biedt een OpenAI-compatibele router voor chatvoltooiingen vóór veel gehoste modellen (DeepSeek, Llama en meer) onder één token. OpenClaw communiceert alleen met het eindpunt voor chatvoltooiingen; gebruik voor tekst-naar-afbeelding, embeddings of spraak rechtstreeks de HF-inferenceclients.

Eigenschap	Waarde
Provider-id	`huggingface`
Plugin	gebundeld (standaard ingeschakeld, geen installatiestap)
Auth-omgevingsvariabele	`HUGGINGFACE_HUB_TOKEN` of `HF_TOKEN` (fijnmazig token)
API	OpenAI-compatibel (`https://router.huggingface.co/v1`)
Facturering	Eén HF-token; prijzen volgen de tarieven van de provider met een gratis niveau

Aan de slag

Een fijnmazig token maken

Ga naar Hugging Face Settings Tokens en maak een nieuw fijnmazig token.

Voor het token moet de machtiging Make calls to Inference Providers zijn ingeschakeld, anders worden API-aanvragen geweigerd.

Onboarding uitvoeren

Kies Hugging Face in de providerkeuzelijst en voer vervolgens je API-sleutel in wanneer daarom wordt gevraagd:

openclaw onboard --auth-choice huggingface-api-key

Een standaardmodel selecteren

Kies een model in de keuzelijst Standaardmodel van Hugging Face. De lijst wordt vanuit de Inference API geladen wanneer je token geldig is; anders toont OpenClaw de ingebouwde catalogus hieronder. Je keuze wordt opgeslagen als agents.defaults.model.primary:

{
  agents: {
    defaults: {
      model: { primary: "huggingface/deepseek-ai/DeepSeek-R1" },
    },
  },
}

Controleren of het model beschikbaar is

openclaw models list --provider huggingface

Niet-interactieve configuratie

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice huggingface-api-key \
  --huggingface-api-key "$HF_TOKEN"

Stelt huggingface/deepseek-ai/DeepSeek-R1 in als standaardmodel.

Model-ID’s

Modelverwijzingen gebruiken de vorm huggingface/<org>/<model> (ID’s in Hub-stijl). De ingebouwde catalogus van OpenClaw:

Model	Verwijzing (voorvoegen met `huggingface/`)
DeepSeek R1	`deepseek-ai/DeepSeek-R1`
DeepSeek V3.1	`deepseek-ai/DeepSeek-V3.1`
GPT-OSS 120B	`openai/gpt-oss-120b`

Wanneer je token geldig is, detecteert OpenClaw tijdens de onboarding en bij het starten van de Gateway ook alle andere modellen via GET https://router.huggingface.co/v1/models, zodat je catalogus veel meer dan de drie bovenstaande modellen kan bevatten. Je kunt :fastest of :cheapest aan elk model-id toevoegen; de router van HF routeert naar de overeenkomende inferenceprovider. Stel je standaardvolgorde van providers in bij de instellingen voor Inference Providers.

Geavanceerde configuratie

Modeldetectie en onboardingkeuzelijst

OpenClaw detecteert modellen met:

GET https://router.huggingface.co/v1/models
Authorization: Bearer $HUGGINGFACE_HUB_TOKEN   # of $HF_TOKEN

Het antwoord heeft de OpenAI-stijl: { "object": "list", "data": [ { "id": "Qwen/Qwen3-8B", "owned_by": "Qwen", ... }, ... ] }.Met een geconfigureerde sleutel (onboarding, HUGGINGFACE_HUB_TOKEN of HF_TOKEN) wordt de keuzelijst Standaardmodel van Hugging Face tijdens de interactieve configuratie vanuit dit eindpunt gevuld. Bij het starten van de Gateway wordt dezelfde aanroep herhaald om de catalogus te vernieuwen. Gedetecteerde modellen worden samengevoegd met de ingebouwde catalogus hierboven (die wordt gebruikt voor metagegevens zoals het contextvenster en de kosten wanneer een id overeenkomt). Als de aanvraag mislukt, geen gegevens retourneert of er geen sleutel is ingesteld, valt OpenClaw uitsluitend terug op de ingebouwde catalogus.Detectie uitschakelen zonder de provider te verwijderen:

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

Modelnamen, aliassen en beleidsachtervoegsels

Naam uit de API: gedetecteerde modellen gebruiken indien aanwezig de name, title of display_name van de API; anders leidt OpenClaw een naam af van het model-id (bijvoorbeeld deepseek-ai/DeepSeek-R1 wordt “DeepSeek R1”).
Weergavenaam overschrijven: stel per model een aangepast label in de configuratie in:

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

Beleidsachtervoegsels: :fastest en :cheapest zijn conventies van de HF-router, niet iets wat OpenClaw herschrijft: het achtervoegsel wordt letterlijk als onderdeel van het model-id verzonden en de router van HF kiest de overeenkomende inferenceprovider. Voeg elke variant als afzonderlijke vermelding toe onder models.providers.huggingface.models (of in model.primary) als je per achtervoegsel een afzonderlijke alias wilt.
Configuratiesamenvoeging: bestaande vermeldingen in models.providers.huggingface.models (bijvoorbeeld in models.json) blijven bij het samenvoegen van de configuratie behouden, zodat aangepaste name, alias of modelopties die je daar instelt ook na herstarts behouden blijven.

Omgevings- en daemonconfiguratie

Als de Gateway als daemon draait (launchd/systemd), zorg er dan voor dat HUGGINGFACE_HUB_TOKEN of HF_TOKEN beschikbaar is voor dat proces (bijvoorbeeld in ~/.openclaw/.env of via env.shellEnv).

OpenClaw accepteert zowel HUGGINGFACE_HUB_TOKEN als HF_TOKEN. Als beide zijn ingesteld, heeft HUGGINGFACE_HUB_TOKEN voorrang.

Configuratie: DeepSeek R1 met terugvalmodel

{
  agents: {
    defaults: {
      model: {
        primary: "huggingface/deepseek-ai/DeepSeek-R1",
        fallbacks: ["huggingface/openai/gpt-oss-120b"],
      },
      models: {
        "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1" },
        "huggingface/openai/gpt-oss-120b": { alias: "GPT-OSS 120B" },
      },
    },
  },
}

Configuratie: DeepSeek met goedkoopste en snelste varianten

{
  agents: {
    defaults: {
      model: { primary: "huggingface/deepseek-ai/DeepSeek-R1" },
      models: {
        "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1" },
        "huggingface/deepseek-ai/DeepSeek-R1:cheapest": { alias: "DeepSeek R1 (cheapest)" },
        "huggingface/deepseek-ai/DeepSeek-R1:fastest": { alias: "DeepSeek R1 (fastest)" },
      },
    },
  },
}

Configuratie: DeepSeek + GPT-OSS met aliassen

{
  agents: {
    defaults: {
      model: {
        primary: "huggingface/deepseek-ai/DeepSeek-V3.1",
        fallbacks: ["huggingface/openai/gpt-oss-120b"],
      },
      models: {
        "huggingface/deepseek-ai/DeepSeek-V3.1": { alias: "DeepSeek V3.1" },
        "huggingface/openai/gpt-oss-120b": { alias: "GPT-OSS 120B" },
      },
    },
  },
}

Gerelateerd

Modelselectie

Overzicht van alle providers, modelverwijzingen en failovergedrag.

Modelselectie

Modellen kiezen en configureren.

Documentatie voor Inference Providers

Officiële documentatie voor Hugging Face Inference Providers.

Configuratie

Volledige configuratiereferentie.

Overview

Concepts and configuration

Providers

Hugging Face (inferentie)

Aan de slag

Niet-interactieve configuratie

Model-ID’s

Geavanceerde configuratie

Gerelateerd

Modelselectie

Modelselectie

Documentatie voor Inference Providers

Configuratie

​Aan de slag

​Niet-interactieve configuratie

​Model-ID’s

​Geavanceerde configuratie

​Gerelateerd

Modelselectie

Modelselectie

Documentatie voor Inference Providers

Configuratie

Aan de slag

Niet-interactieve configuratie

Model-ID’s

Geavanceerde configuratie

Gerelateerd