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 token 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örüntü oluşturma, gömme 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 token)
API OpenAI uyumlu (https://router.huggingface.co/v1)
Faturalandırma Tek HF token'ı; fiyatlandırma, ücretsiz katmanla birlikte sağlayıcı ücretlerini izler

Başlarken

  • Ayrıntılı izinlere sahip bir token oluşturun

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

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

    Sağlayıcı açılır listesinden 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

    Default Hugging Face model açılır listesinden bir model seçin. Token'ınız geçerliyse liste Inference API'den 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 değerini varsayılan model olarak ayarlar.

    Model kimlikleri

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

    Model Referans (başına huggingface/ ekleyin)
    DeepSeek R1 deepseek-ai/DeepSeek-R1
    DeepSeek V3.1 deepseek-ai/DeepSeek-V3.1
    GPT-OSS 120B openai/gpt-oss-120b

    Gelişmiş yapılandırma

    Model keşfi ve ilk kurulum açılır listesi

    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 varsa (ilk kurulum, HUGGINGFACE_HUB_TOKEN veya HF_TOKEN), etkileşimli kurulum sırasında Default Hugging Face model açılır listesi 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 son ekleri
    • API'den gelen ad: Keşfedilen modeller, mevcut olduğunda API'nin name, title veya display_name değerini kullanır; aksi takdirde OpenClaw model kimliğinden bir ad türetir (ör. 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 son ekleri: :fastest ve :cheapest, OpenClaw'ın yeniden yazdığı değerler değil, HF yönlendirici kurallarıdır: son ek, 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 son ek için farklı bir diğer ad istiyorsanız her çeşidi models.providers.huggingface.models altında (veya model.primary içinde) ayrı bir girdi olarak ekleyin.
    • Yapılandırma birleştirme: models.providers.huggingface.models içindeki mevcut girdiler (ör. models.json içinde) yapılandırma birleştirilirken korunur; dolayısıyla burada ayarladığınız özel name, alias veya model seçenekleri yeniden başlatmalarda 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ğerinin 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: Yedek model içeren 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 + GPT-OSS
    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" },      },    },  },}

    İlgili içerikler

    Model seçimi

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

    Modellerin nasıl seçilip yapılandırılacağı.
    Inference Providers belgeleri

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

    Tam yapılandırma referansı.
    Was this useful?
    On this page

    On this page