Hugging Face (inferência)

O OpenClaw descobre modelos com:

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

A resposta segue o estilo da OpenAI: { "object": "list", "data": [ { "id": "Qwen/Qwen3-8B", "owned_by": "Qwen", ... }, ... ] }.

Com uma chave configurada (na integração inicial, em HUGGINGFACE_HUB_TOKEN ou em HF_TOKEN), o menu suspenso Modelo padrão do Hugging Face durante a configuração interativa é preenchido por esse endpoint. A inicialização do Gateway repete a mesma chamada para atualizar o catálogo. Os modelos descobertos são combinados com o catálogo integrado acima (usado para metadados como janela de contexto e custo quando há correspondência de ID). Se a solicitação falhar, não retornar dados ou nenhuma chave estiver definida, o OpenClaw usará somente o catálogo integrado.

Desabilite a descoberta sem remover o provedor:

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

• Nome da API: os modelos descobertos usam name, title ou display_name da API quando disponíveis; caso contrário, o OpenClaw deriva um nome do ID do modelo (por exemplo, deepseek-ai/DeepSeek-R1 se torna "DeepSeek R1").
• Substituir o nome de exibição: defina um rótulo personalizado por modelo na configuração:

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

• Sufixos de política: :fastest e :cheapest são convenções do roteador da HF, não algo que o OpenClaw reescreva: o sufixo é enviado literalmente como parte do ID do modelo, e o roteador da HF escolhe o provedor de inferência correspondente. Adicione cada variante como uma entrada própria em models.providers.huggingface.models (ou em model.primary) caso queira um alias diferente para cada sufixo.
• Mesclagem da configuração: as entradas existentes em models.providers.huggingface.models (por exemplo, em models.json) são mantidas durante a mesclagem da configuração, portanto qualquer name, alias ou opção de modelo personalizada definida ali persiste entre reinicializações.

Se o Gateway for executado como um daemon (launchd/systemd), verifique se HUGGINGFACE_HUB_TOKEN ou HF_TOKEN está disponível para esse processo (por exemplo, em ~/.openclaw/.env ou por meio de env.shellEnv).