Hugging Face w OpenClaw — tysiace modeli z jednym tokenem

Przeglad

Dostawca Hugging Face w OpenClaw umozliwia dostep do uzupelnien czatu kompatybilnych z OpenAI za posrednictwem ujednoliconego API routera. Dzieki temu zyskujesz dostep do wielu modeli (DeepSeek, Llama, Qwen i innych) z jednym tokenem autoryzacyjnym — bez koniecznosci tworzenia kont u poszczegolnych dostawcow.

Identyfikacja dostawcy

• Identyfikator: huggingface
• API: kompatybilne z OpenAI
• Endpoint: https://router.huggingface.co/v1

Uwierzytelnianie

Mozesz uzyc jednej z dwoch zmiennych srodowiskowych (obie dzialaja zamiennie):

• HUGGINGFACE_HUB_TOKEN
• HF_TOKEN

Oba tokeny wymagaja uprawnien "Make calls to Inference Providers". Utworzysz je w ustawieniach Hugging Face (Settings → Tokens) z odpowiednimi zakresami.

Konfiguracja

Interaktywna

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

Kreator wyswietli liste modeli pobraną z endpointu GET https://router.huggingface.co/v1/models.

Nieinteraktywna

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

Format nazw modeli

Modele sa identyfikowane w formacie huggingface/<organizacja>/<model>. Dostepne sa dwa sufiksy polityki routingu:

• :fastest — priorytetyzuje przepustowosc (najszybsza odpowiedz)
• :cheapest — minimalizuje koszty tokenow wyjsciowych

Konfiguracja z aliasami i fallbackami

{
  agents: {
    defaults: {
      model: {
        primary: "huggingface/deepseek-ai/DeepSeek-R1",
        fallbacks: ["huggingface/Qwen/Qwen3-8B"]
      },
      models: {
        "huggingface/deepseek-ai/DeepSeek-R1": {
          alias: "DeepSeek R1"
        },
        "huggingface/Qwen/Qwen3-8B": {
          alias: "Qwen3 8B"
        }
      }
    }
  }
}

Obslugiwane modele

Hugging Face udostepnia szeroki katalog modeli, w tym:

• DeepSeek R1, V3.2 — modele z zaawansowanym rozumowaniem
• Qwen3 8B/32B, Qwen2.5 7B Instruct — modele Alibaba Cloud
• Llama 3.3 70B, Llama 3.1 8B Instruct — modele Meta
• GPT-OSS 120B — duzy model open-source
• GLM 4.7 — model Zhipu AI
• Kimi K2.5 — model Moonshot AI

Pelna lista modeli jest pobierana dynamicznie podczas konfiguracji i uruchamiania OpenClaw.

Wazne uwagi

• Przy wdrozeniach daemonowych (launchd/systemd) upewnij sie, ze token jest dostepny w ~/.openclaw/.env.
• Polityka :fastest jest zalecana dla interaktywnych zastosowan czatowych.
• Polityka :cheapest jest idealna dla przetwarzania wsadowego (batch processing).
• Hugging Face oferuje darmowy tier do testowania — swietny do prototypowania przed wyborem docelowego dostawcy.