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

Providers

Hugging Face (inferensi)

Hugging Face Inference Providers menyediakan router penyelesaian chat yang kompatibel dengan OpenAI untuk banyak model yang di-host (DeepSeek, Llama, dan lainnya) dengan satu token. OpenClaw hanya berkomunikasi dengan endpoint penyelesaian chat; untuk teks-ke-gambar, embedding, atau ucapan, gunakan klien inferensi HF secara langsung.

Properti Nilai
ID penyedia huggingface
Plugin bawaan (diaktifkan secara default, tanpa langkah instalasi)
Variabel lingkungan autentikasi HUGGINGFACE_HUB_TOKEN atau HF_TOKEN (token terperinci)
API Kompatibel dengan OpenAI (https://router.huggingface.co/v1)
Penagihan Satu token HF; harga mengikuti tarif penyedia dengan tingkat gratis

Memulai

  • Buat token terperinci

    Buka Hugging Face Settings Tokens dan buat token terperinci baru.

  • Jalankan orientasi awal

    Pilih Hugging Face dalam daftar tarik-turun penyedia, lalu masukkan kunci API saat diminta:

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

  • Pilih model default

    Dalam daftar tarik-turun Default Hugging Face model, pilih model. Daftar dimuat dari Inference API saat token Anda valid; jika tidak, OpenClaw menampilkan katalog bawaan di bawah. Pilihan Anda disimpan sebagai agents.defaults.model.primary:

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

  • Verifikasi bahwa model tersedia

    bash
    openclaw models list --provider huggingface

    • Penyiapan noninteraktif

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

    Menetapkan huggingface/deepseek-ai/DeepSeek-R1 sebagai model default.

    ID model

    Referensi model menggunakan format huggingface/<org>/<model> (ID bergaya Hub). Katalog bawaan OpenClaw:

    Model Referensi (awali dengan huggingface/)
    DeepSeek R1 deepseek-ai/DeepSeek-R1
    DeepSeek V3.1 deepseek-ai/DeepSeek-V3.1
    GPT-OSS 120B openai/gpt-oss-120b

    Konfigurasi lanjutan

    Penemuan model dan daftar tarik-turun orientasi awal

    OpenClaw menemukan model dengan:

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

    Responsnya bergaya OpenAI: { "object": "list", "data": [ { "id": "Qwen/Qwen3-8B", "owned_by": "Qwen", ... }, ... ] }.

    Dengan kunci yang dikonfigurasi (orientasi awal, HUGGINGFACE_HUB_TOKEN, atau HF_TOKEN), daftar tarik-turun Default Hugging Face model selama penyiapan interaktif diisi dari endpoint ini. Saat Gateway dimulai, panggilan yang sama diulangi untuk menyegarkan katalog. Model yang ditemukan digabungkan dengan katalog bawaan di atas (digunakan untuk metadata seperti jendela konteks dan biaya saat ID cocok). Jika permintaan gagal, tidak mengembalikan data, atau tidak ada kunci yang ditetapkan, OpenClaw hanya kembali menggunakan katalog bawaan.

    Nonaktifkan penemuan tanpa menghapus penyedia:

    bash
    openclaw config set plugins.entries.huggingface.config.discovery.enabled false
    Nama model, alias, dan sufiks kebijakan
    • Nama dari API: model yang ditemukan menggunakan name, title, atau display_name dari API jika tersedia; jika tidak, OpenClaw memperoleh nama dari ID model (misalnya deepseek-ai/DeepSeek-R1 menjadi "DeepSeek R1").
    • Timpa nama tampilan: tetapkan label khusus per model dalam konfigurasi:
    json5
    {  agents: {    defaults: {      models: {        "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1 (fast)" },        "huggingface/deepseek-ai/DeepSeek-R1:cheapest": { alias: "DeepSeek R1 (cheap)" },      },    },  },}
    • Sufiks kebijakan: :fastest dan :cheapest adalah konvensi router HF, bukan sesuatu yang ditulis ulang oleh OpenClaw: sufiks dikirim apa adanya sebagai bagian dari ID model dan router HF memilih penyedia inferensi yang cocok. Tambahkan setiap varian sebagai entrinya sendiri di bawah models.providers.huggingface.models (atau dalam model.primary) jika Anda menginginkan alias yang berbeda untuk setiap sufiks.
    • Penggabungan konfigurasi: entri yang sudah ada dalam models.providers.huggingface.models (misalnya dalam models.json) dipertahankan saat konfigurasi digabungkan, sehingga name, alias, atau opsi model khusus apa pun yang Anda tetapkan di sana tetap ada setelah dimulai ulang.
    Penyiapan lingkungan dan daemon

    Jika Gateway berjalan sebagai daemon (launchd/systemd), pastikan HUGGINGFACE_HUB_TOKEN atau HF_TOKEN tersedia untuk proses tersebut (misalnya, dalam ~/.openclaw/.env atau melalui env.shellEnv).

    Konfigurasi: DeepSeek R1 dengan fallback
    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" },      },    },  },}
    Konfigurasi: DeepSeek dengan varian termurah dan tercepat
    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)" },      },    },  },}
    Konfigurasi: DeepSeek + GPT-OSS dengan alias
    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" },      },    },  },}

    Terkait

    Pemilihan model

    Ikhtisar semua penyedia, referensi model, dan perilaku failover.
    Pemilihan model

    Cara memilih dan mengonfigurasi model.
    Dokumentasi Inference Providers

    Dokumentasi resmi Hugging Face Inference Providers.
    Konfigurasi

    Referensi konfigurasi lengkap.
    Was this useful?
    On this page

    On this page