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

Providers

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.

  • Onboarding uitvoeren

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

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

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

  • Controleren of het model beschikbaar is

    bash
    openclaw models list --provider huggingface

    • Niet-interactieve configuratie

    bash
    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

    Geavanceerde configuratie

    Modeldetectie en onboardingkeuzelijst

    OpenClaw detecteert modellen met:

    bash
    GET https://router.huggingface.co/v1/modelsAuthorization: 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:

    bash
    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:
    json5
    {  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).

    Configuratie: DeepSeek R1 met terugvalmodel
    json5
    {  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
    json5
    {  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
    json5
    {  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.
    Was this useful?
    On this page

    On this page