Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Hugging Face Inference Providers, tek bir yönlendirici API üzerinden OpenAI uyumlu chat completions sunar. Tek bir token ile birçok modele (DeepSeek, Llama ve daha fazlası) erişirsiniz. OpenClaw, OpenAI uyumlu uç noktayı kullanır (yalnızca chat completions); text-to-image, embeddings veya konuşma için HF inference clients doğrudan kullanılmalıdır.
  • Sağlayıcı: huggingface
  • Kimlik doğrulama: HUGGINGFACE_HUB_TOKEN veya HF_TOKEN (Make calls to Inference Providers iznine sahip ince ayarlı token)
  • API: OpenAI uyumlu (https://router.huggingface.co/v1)
  • Faturalama: Tek HF token; fiyatlandırma sağlayıcı ücretlerini izler ve ücretsiz katman içerir.

​
Başlarken

1

İnce ayarlı bir token oluşturun

Hugging Face Settings Tokens sayfasına gidin ve yeni bir ince ayarlı token oluşturun.
Token üzerinde Make calls to Inference Providers izni etkin olmalıdır; aksi hâlde API istekleri reddedilir.
2

Onboarding çalıştırın

Sağlayıcı açılır menüsünde Hugging Face seçin, ardından istendiğinde API anahtarınızı girin:
openclaw onboard --auth-choice huggingface-api-key
3

Varsayılan bir model seçin

Default Hugging Face model açılır menüsünden istediğiniz modeli seçin. Geçerli bir token varsa liste Inference API’den yüklenir; aksi hâlde yerleşik liste gösterilir. Seçiminiz varsayılan model olarak kaydedilir.Varsayılan modeli daha sonra yapılandırmada da ayarlayabilir veya değiştirebilirsiniz:
{
  agents: {
    defaults: {
      model: { primary: "huggingface/deepseek-ai/DeepSeek-R1" },
    },
  },
}
4

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

openclaw models list --provider huggingface

​
Etkileşimsiz kurulum

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice huggingface-api-key \
  --huggingface-api-key "$HF_TOKEN"
Bu, 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). Aşağıdaki liste GET https://router.huggingface.co/v1/models çıktısındandır; kataloğunuz daha fazlasını içerebilir.
ModelBaşvuru (huggingface/ ile önekleyin)
DeepSeek R1deepseek-ai/DeepSeek-R1
DeepSeek V3.2deepseek-ai/DeepSeek-V3.2
Qwen3 8BQwen/Qwen3-8B
Qwen2.5 7B InstructQwen/Qwen2.5-7B-Instruct
Qwen3 32BQwen/Qwen3-32B
Llama 3.3 70B Instructmeta-llama/Llama-3.3-70B-Instruct
Llama 3.1 8B Instructmeta-llama/Llama-3.1-8B-Instruct
GPT-OSS 120Bopenai/gpt-oss-120b
GLM 4.7zai-org/GLM-4.7
Kimi K2.5moonshotai/Kimi-K2.5
Her model kimliğinin sonuna :fastest veya :cheapest ekleyebilirsiniz. Varsayılan sıranızı Inference Provider settings içinde ayarlayın; tam liste için Inference Providers ve GET https://router.huggingface.co/v1/models bölümüne bakın.

​
Gelişmiş yapılandırma

OpenClaw, modelleri Inference endpoint’e doğrudan çağrı yaparak keşfeder:
GET https://router.huggingface.co/v1/models
(İsteğe bağlı: tam liste için Authorization: Bearer $HUGGINGFACE_HUB_TOKEN veya $HF_TOKEN gönderin; bazı uç noktalar kimlik doğrulama olmadan yalnızca alt küme döndürür.) Yanıt OpenAI tarzı { "object": "list", "data": [ { "id": "Qwen/Qwen3-8B", "owned_by": "Qwen", ... }, ... ] } biçimindedir.Bir Hugging Face API anahtarı yapılandırdığınızda (onboarding, HUGGINGFACE_HUB_TOKEN veya HF_TOKEN üzerinden), OpenClaw kullanılabilir chat-completion modellerini keşfetmek için bu GET çağrısını kullanır. Etkileşimli kurulum sırasında, token’ınızı girdikten sonra bu listeden doldurulan (veya istek başarısız olursa yerleşik katalogdan gelen) bir Default Hugging Face model açılır menüsü görürsünüz. Çalışma zamanında (örneğin Gateway başlangıcında), anahtar mevcut olduğunda OpenClaw katalogu yenilemek için yine GET https://router.huggingface.co/v1/models çağrısını yapar. Liste, yerleşik bir katalogla (bağlam penceresi ve maliyet gibi meta veriler için) birleştirilir. İstek başarısız olursa veya anahtar ayarlı değilse yalnızca yerleşik katalog kullanılır.
  • API’den gelen ad: Model görünen adı, API name, title veya display_name döndürdüğünde GET /v1/models üzerinden doldurulur; aksi hâlde model kimliğinden türetilir (örneğin deepseek-ai/DeepSeek-R1, “DeepSeek R1” olur).
  • Görünen adı geçersiz kıl: CLI ve UI içinde istediğiniz şekilde görünmesi için yapılandırmada model başına özel bir etiket ayarlayabilirsiniz:
{
  agents: {
    defaults: {
      models: {
        "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1 (hızlı)" },
        "huggingface/deepseek-ai/DeepSeek-R1:cheapest": { alias: "DeepSeek R1 (ucuz)" },
      },
    },
  },
}
  • İlke sonekleri: OpenClaw’ın paketle gelen Hugging Face belgeleri ve yardımcıları şu iki soneki yerleşik ilke varyantları olarak değerlendirir:
    • :fastest — en yüksek işlem hacmi.
    • :cheapest — çıktı belirteci başına en düşük maliyet.
    Bunları models.providers.huggingface.models içinde ayrı girdiler olarak ekleyebilir veya model.primary değerini sonekli ayarlayabilirsiniz. Varsayılan sağlayıcı sıranızı Inference Provider settings içinde de ayarlayabilirsiniz (sonek yoksa = o sırayı kullan).
  • Yapılandırma birleştirme: models.providers.huggingface.models içindeki mevcut girdiler (örneğin models.json içinde olanlar) yapılandırma birleştirilirken korunur. Böylece orada ayarladığınız özel name, alias veya model seçenekleri korunur.
Gateway bir daemon (launchd/systemd) olarak çalışıyorsa HUGGINGFACE_HUB_TOKEN veya HF_TOKEN değerinin o sürece de mevcut olduğundan emin olun (örneğin ~/.openclaw/.env içinde veya env.shellEnv üzerinden).
OpenClaw, ortam değişkeni takma adları olarak hem HUGGINGFACE_HUB_TOKEN hem de HF_TOKEN kabul eder. İkisinden biri çalışır; ikisi de ayarlıysa HUGGINGFACE_HUB_TOKEN önceliklidir.
{
  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" },
      },
    },
  },
}

{
  agents: {
    defaults: {
      model: { primary: "huggingface/Qwen/Qwen3-8B" },
      models: {
        "huggingface/Qwen/Qwen3-8B": { alias: "Qwen3 8B" },
        "huggingface/Qwen/Qwen3-8B:cheapest": { alias: "Qwen3 8B (en ucuz)" },
        "huggingface/Qwen/Qwen3-8B:fastest": { alias: "Qwen3 8B (en hızlı)" },
      },
    },
  },
}

{
  agents: {
    defaults: {
      model: {
        primary: "huggingface/deepseek-ai/DeepSeek-V3.2",
        fallbacks: [
          "huggingface/meta-llama/Llama-3.3-70B-Instruct",
          "huggingface/openai/gpt-oss-120b",
        ],
      },
      models: {
        "huggingface/deepseek-ai/DeepSeek-V3.2": { alias: "DeepSeek V3.2" },
        "huggingface/meta-llama/Llama-3.3-70B-Instruct": { alias: "Llama 3.3 70B" },
        "huggingface/openai/gpt-oss-120b": { alias: "GPT-OSS 120B" },
      },
    },
  },
}

{
  agents: {
    defaults: {
      model: { primary: "huggingface/Qwen/Qwen2.5-7B-Instruct:cheapest" },
      models: {
        "huggingface/Qwen/Qwen2.5-7B-Instruct": { alias: "Qwen2.5 7B" },
        "huggingface/Qwen/Qwen2.5-7B-Instruct:cheapest": { alias: "Qwen2.5 7B (ucuz)" },
        "huggingface/deepseek-ai/DeepSeek-R1:fastest": { alias: "DeepSeek R1 (hızlı)" },
        "huggingface/meta-llama/Llama-3.1-8B-Instruct": { alias: "Llama 3.1 8B" },
      },
    },
  },
}

​
İlgili

Model seçimi

Tüm sağlayıcılar, model başvuruları ve devretme davranışı için 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

Tam yapılandırma başvurusu.