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

Providers

Hugging Face (çıkarım)

Hugging Face Inference Providers, tek bir belirteç altında barındırılan birçok modelin (DeepSeek, Llama ve daha fazlası) önünde OpenAI uyumlu bir sohbet tamamlama yönlendiricisi sunar. OpenClaw yalnızca sohbet tamamlama uç noktasıyla iletişim kurar; metinden görsele dönüştürme, gömmeler veya konuşma için doğrudan HF çıkarım istemcilerini kullanın.

Özellik Değer
Sağlayıcı kimliği huggingface
Plugin paketle birlikte gelir (varsayılan olarak etkindir, kurulum adımı yoktur)
Kimlik doğrulama ortam değişkeni HUGGINGFACE_HUB_TOKEN veya HF_TOKEN (ayrıntılı izinlere sahip belirteç)
API OpenAI uyumlu (https://router.huggingface.co/v1)
Faturalandırma Tek HF belirteci; fiyatlandırma, ücretsiz katmanla birlikte sağlayıcı ücretlerini izler

Başlarken

  • Ayrıntılı izinlere sahip bir belirteç oluşturun

    Hugging Face Settings Tokens sayfasına gidin ve ayrıntılı izinlere sahip yeni bir belirteç oluşturun.

  • İlk kurulumu çalıştırın

    Sağlayıcı açılır menüsünde Hugging Face seçeneğini belirleyin, ardından istendiğinde API anahtarınızı girin:

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

  • Varsayılan bir model seçin

    Varsayılan Hugging Face modeli açılır menüsünden bir model seçin. Belirteciniz geçerliyse liste Inference API üzerinden yüklenir; aksi takdirde OpenClaw aşağıdaki yerleşik kataloğu gösterir. Seçiminiz agents.defaults.model.primary olarak kaydedilir:

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

  • Modelin kullanılabilir olduğunu doğrulayın

    bash
    openclaw models list --provider huggingface

    • Etkileşimsiz kurulum

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

    huggingface/deepseek-ai/DeepSeek-R1 modelini varsayılan model olarak ayarlar.

    Model kimlikleri

    Model başvuruları huggingface/<org>/<model> biçimini kullanır (Hub tarzı kimlikler). OpenClaw'ın yerleşik kataloğu:

    Model Başvuru (huggingface/ önekiyle)
    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

    Gelişmiş yapılandırma

    Model keşfi ve ilk kurulum açılır menüsü

    OpenClaw modelleri şu istekle keşfeder:

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

    Yanıt OpenAI tarzındadır: { "object": "list", "data": [ { "id": "Qwen/Qwen3-8B", "owned_by": "Qwen", ... }, ... ] }.

    Yapılandırılmış bir anahtar bulunduğunda (ilk kurulum, HUGGINGFACE_HUB_TOKEN veya HF_TOKEN), etkileşimli kurulum sırasındaki Varsayılan Hugging Face modeli açılır menüsü bu uç noktadan doldurulur. Gateway başlatılırken kataloğu yenilemek için aynı çağrı tekrarlanır. Keşfedilen modeller yukarıdaki yerleşik katalogla birleştirilir (bir kimlik eşleştiğinde bağlam penceresi ve maliyet gibi meta veriler için kullanılır). İstek başarısız olursa, veri döndürmezse veya herhangi bir anahtar ayarlanmamışsa OpenClaw yalnızca yerleşik kataloğu kullanır.

    Sağlayıcıyı kaldırmadan keşfi devre dışı bırakın:

    bash
    openclaw config set plugins.entries.huggingface.config.discovery.enabled false
    Model adları, diğer adlar ve ilke sonekleri
    • API'den gelen ad: keşfedilen modeller, varsa API'nin name, title veya display_name değerini kullanır; aksi takdirde OpenClaw model kimliğinden bir ad türetir (örneğin deepseek-ai/DeepSeek-R1, "DeepSeek R1" olur).
    • Görünen adı geçersiz kılma: yapılandırmada her model için özel bir etiket ayarlayın:
    json5
    {  agents: {    defaults: {      models: {        "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1 (fast)" },        "huggingface/deepseek-ai/DeepSeek-R1:cheapest": { alias: "DeepSeek R1 (cheap)" },      },    },  },}
    • İlke sonekleri: :fastest ve :cheapest, OpenClaw'ın yeniden yazdığı ifadeler değil, HF yönlendirici kurallarıdır: sonek model kimliğinin bir parçası olarak aynen gönderilir ve HF yönlendiricisi eşleşen çıkarım sağlayıcısını seçer. Her sonek için ayrı bir diğer ad istiyorsanız her çeşidi models.providers.huggingface.models altında (veya model.primary içinde) kendi girdisi olarak ekleyin.
    • Yapılandırma birleştirme: models.providers.huggingface.models içindeki mevcut girdiler (örneğin models.json içindekiler) yapılandırma birleştirilirken korunur; dolayısıyla burada ayarladığınız özel name, alias veya model seçenekleri yeniden başlatmalar boyunca kalıcı olur.
    Ortam ve arka plan hizmeti kurulumu

    Gateway bir arka plan hizmeti (launchd/systemd) olarak çalışıyorsa HUGGINGFACE_HUB_TOKEN veya HF_TOKEN değişkeninin bu süreç tarafından kullanılabildiğinden emin olun (örneğin ~/.openclaw/.env içinde veya env.shellEnv aracılığıyla).

    Yapılandırma: Yedekli DeepSeek R1
    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" },      },    },  },}
    Yapılandırma: En ucuz ve en hızlı çeşitleriyle DeepSeek
    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)" },      },    },  },}
    Yapılandırma: Diğer adlarla DeepSeek + Llama + GPT-OSS
    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" },      },    },  },}

    İlgili içerikler

    Model seçimi

    Tüm sağlayıcılara, model başvurularına ve yük devretme davranışına genel bakış.
    Model seçimi

    Modellerin nasıl seçileceği ve yapılandırılacağı.
    Inference Providers belgeleri

    Resmî Hugging Face Inference Providers belgeleri.
    Yapılandırma

    Eksiksiz yapılandırma başvurusu.
    Was this useful?
    On this page

    On this page