Hugging Face (Inferenz)

OpenClaw erkennt Modelle mit:

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

Die Antwort verwendet das OpenAI-Format: { "object": "list", "data": [ { "id": "Qwen/Qwen3-8B", "owned_by": "Qwen", ... }, ... ] }.

Wenn ein Schlüssel konfiguriert ist (über die Ersteinrichtung, HUGGINGFACE_HUB_TOKEN oder HF_TOKEN), wird das Dropdown Default Hugging Face model während der interaktiven Einrichtung über diesen Endpunkt befüllt. Beim Start des Gateway wird derselbe Aufruf erneut ausgeführt, um den Katalog zu aktualisieren. Erkannte Modelle werden mit dem oben aufgeführten integrierten Katalog zusammengeführt, der bei übereinstimmender ID für Metadaten wie Kontextfenster und Kosten verwendet wird. Wenn die Anfrage fehlschlägt, keine Daten zurückgibt oder kein Schlüssel festgelegt ist, greift OpenClaw ausschließlich auf den integrierten Katalog zurück.

So deaktivieren Sie die Erkennung, ohne den Provider zu entfernen:

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

• Name aus der API: Erkannte Modelle verwenden den API-Wert name, title oder display_name, sofern vorhanden; andernfalls leitet OpenClaw einen Namen aus der Modell-ID ab (beispielsweise wird deepseek-ai/DeepSeek-R1 zu „DeepSeek R1“).
• Anzeigenamen überschreiben: Legen Sie in der Konfiguration für jedes Modell eine benutzerdefinierte Bezeichnung fest:

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

• Richtliniensuffixe: :fastest und :cheapest sind Konventionen des HF-Routers und werden von OpenClaw nicht umgeschrieben: Das Suffix wird unverändert als Bestandteil der Modell-ID gesendet, und der Router von HF wählt den passenden Inferenz-Provider aus. Fügen Sie jede Variante als eigenen Eintrag unter models.providers.huggingface.models oder in model.primary hinzu, wenn Sie für jedes Suffix einen eigenen Alias verwenden möchten.
• Zusammenführen der Konfiguration: Vorhandene Einträge in models.providers.huggingface.models (beispielsweise in models.json) bleiben beim Zusammenführen der Konfiguration erhalten. Dadurch bleiben alle dort festgelegten benutzerdefinierten Werte für name, alias oder Modelloptionen über Neustarts hinweg bestehen.

Wenn das Gateway als Daemon (launchd/systemd) ausgeführt wird, stellen Sie sicher, dass HUGGINGFACE_HUB_TOKEN oder HF_TOKEN für diesen Prozess verfügbar ist, beispielsweise in ~/.openclaw/.env oder über env.shellEnv.