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)

Penyedia Inferensi Hugging Face menyediakan perute penyelesaian percakapan yang kompatibel dengan OpenAI di depan banyak model yang dihosting (DeepSeek, Llama, dan lainnya) dengan satu token. OpenClaw hanya berkomunikasi dengan titik akhir penyelesaian percakapan; 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 tingkatan gratis

Memulai

  • Buat token terperinci

    Buka Pengaturan Token Hugging Face dan buat token terperinci baru.

  • Jalankan orientasi awal

    Pilih Hugging Face di menu tarik-turun penyedia, lalu masukkan kunci API Anda saat diminta:

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

  • Pilih model default

    Di menu tarik-turun Model Hugging Face default, pilih model. Daftar dimuat dari API Inferensi saat token Anda valid; jika tidak, OpenClaw menampilkan katalog bawaan di bawah ini. 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
    Llama 3.3 70B Instruct Turbo meta-llama/Llama-3.3-70B-Instruct-Turbo

    Konfigurasi lanjutan

    Penemuan model dan menu tarik-turun orientasi awal

    OpenClaw menemukan model dengan:

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

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

    Dengan kunci yang telah dikonfigurasi (orientasi awal, HUGGINGFACE_HUB_TOKEN, atau HF_TOKEN), menu tarik-turun Model Hugging Face default selama penyiapan interaktif diisi dari titik akhir 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 menggunakan katalog bawaan sebagai cadangan.

    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").
    • Ganti nama tampilan: tetapkan label khusus untuk setiap 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 perute HF, bukan sesuatu yang ditulis ulang oleh OpenClaw: sufiks dikirim apa adanya sebagai bagian dari ID model dan perute HF memilih penyedia inferensi yang sesuai. Tambahkan setiap varian sebagai entri tersendiri 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 model cadangan
    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 + Llama + GPT-OSS dengan alias
    json5
    {  agents: {    defaults: {      model: {        primary: "huggingface/deepseek-ai/DeepSeek-V3.1",        fallbacks: [          "huggingface/meta-llama/Llama-3.3-70B-Instruct-Turbo",          "huggingface/openai/gpt-oss-120b",        ],      },      models: {        "huggingface/deepseek-ai/DeepSeek-V3.1": { alias: "DeepSeek V3.1" },        "huggingface/meta-llama/Llama-3.3-70B-Instruct-Turbo": { alias: "Llama 3.3 70B Turbo" },        "huggingface/openai/gpt-oss-120b": { alias: "GPT-OSS 120B" },      },    },  },}

    Terkait

    Pemilihan model

    Ikhtisar semua penyedia, referensi model, dan perilaku pengalihan kegagalan.
    Pemilihan model

    Cara memilih dan mengonfigurasi model.
    Dokumentasi Penyedia Inferensi

    Dokumentasi resmi Penyedia Inferensi Hugging Face.
    Konfigurasi

    Referensi konfigurasi lengkap.
    Was this useful?
    On this page

    On this page