Ana içeriğe atla
NVIDIA, ücretsiz açık modeller için https://integrate.api.nvidia.com/v1 adresinde OpenAI uyumlu bir API sağlar. build.nvidia.com üzerinden alınan bir API anahtarıyla kimlik doğrulaması yapın. OpenClaw, NVIDIA sağlayıcısının varsayılanını uzun bağlamlı ajan tabanlı işler için NVIDIA’nın 550B toplam / 55B aktif akıl yürütme modeli olan Nemotron 3 Ultra olarak ayarlar.

​
Başlarken

1

API anahtarınızı alın

build.nvidia.com üzerinde bir API anahtarı oluşturun.
2

Anahtarı dışa aktarın ve onboarding'i çalıştırın

export NVIDIA_API_KEY="nvapi-..."
openclaw onboard --auth-choice nvidia-api-key
3

Bir NVIDIA modeli ayarlayın

openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b
Env var yerine --nvidia-api-key geçirirseniz, değer kabuk geçmişine ve ps çıktısına düşer. Mümkün olduğunda NVIDIA_API_KEY ortam değişkenini tercih edin.
Etkileşimsiz kurulum için anahtarı doğrudan da geçirebilirsiniz: 
openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."

​
Yapılandırma örneği

{
  env: { NVIDIA_API_KEY: "nvapi-..." },
  models: {
    providers: {
      nvidia: {
        baseUrl: "https://integrate.api.nvidia.com/v1",
        api: "openai-completions",
      },
    },
  },
  agents: {
    defaults: {
      model: { primary: "nvidia/nvidia/nemotron-3-ultra-550b-a55b" },
    },
  },
}

​
Öne çıkan katalog

Bir NVIDIA API anahtarı yapılandırıldığında, OpenClaw kurulum ve model seçimi yolları https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json adresinden NVIDIA’nın herkese açık öne çıkan model kataloğunu dener ve sıralı sonucu 24 saat boyunca önbelleğe alır. Bu nedenle build.nvidia.com’daki yeni öne çıkan modeller, OpenClaw sürümünü beklemeden kurulum ve model seçimi yüzeylerinde görünür. Canlı akış kullanılabilir olduğunda, döndürülen ilk model NVIDIA kurulumu sırasında gösterilen varsayılan seçenektir. Getirme işlemi assets.ngc.nvidia.com için sabit bir HTTPS ana makine ilkesi kullanır. Hiçbir NVIDIA API anahtarı yapılandırılmamışsa veya bu herkese açık katalog kullanılamıyor ya da bozuksa, OpenClaw aşağıdaki paketli kataloğa ve paketli varsayılana geri döner.

​
Nemotron 3 Ultra

Nemotron 3 Ultra, OpenClaw’daki varsayılan NVIDIA modelidir. NVIDIA’nın nvidia/nemotron-3-ultra-550b-a55b için build sayfası, bunu 1M-token bağlam belirtimine sahip kullanılabilir ücretsiz bir endpoint olarak listeler. Paketli katalog, barındırılan endpoint için NVIDIA’nın mevcut OpenAI uyumlu örnek isteğiyle eşleşmesi için 16.384-token maksimum çıktıyı kaydeder. En yüksek kapasiteli NVIDIA varsayılanı için Ultra’yı kullanın. Daha küçük Nemotron 3 seçeneğini istediğinizde Super’i seçili tutun veya bağlamı, gecikmesi ya da davranışı daha uygunsa NVIDIA’nın kataloğunda barındırılan üçüncü taraf modellerden birini seçin. Paketli Ultra satırı, normal sohbet çıktısının akıl yürütme metnini açığa çıkarmak yerine görünür yanıtta kalması için varsayılan olarak chat_template_kwargs.enable_thinking: false ve force_nonempty_content: true gönderir.

​
Paketli geri dönüş kataloğu

Model refAdBağlamMaks. çıktıNotlar
nvidia/nvidia/nemotron-3-ultra-550b-a55bNVIDIA Nemotron 3 Ultra 550B1.000.00016.384Varsayılan
nvidia/nvidia/nemotron-3-super-120b-a12bNVIDIA Nemotron 3 Super 120B1.048.5768.192Öne çıkan geri dönüş
nvidia/moonshotai/kimi-k2.5Kimi K2.5262.1448.192Öne çıkan geri dönüş
nvidia/minimaxai/minimax-m2.7Minimax M2.7196.6088.192Öne çıkan geri dönüş
nvidia/z-ai/glm-5.1GLM 5.1202.7528.192Öne çıkan geri dönüş
nvidia/minimaxai/minimax-m2.5MiniMax M2.5196.6088.192Kullanımdan kaldırıldı, yükseltme uyumluluğu
nvidia/z-ai/glm5GLM-5202.7528.192Kullanımdan kaldırıldı, yükseltme uyumluluğu

​
Gelişmiş yapılandırma

NVIDIA_API_KEY ortam değişkeni ayarlandığında sağlayıcı otomatik olarak etkinleşir. Anahtar dışında açık bir sağlayıcı yapılandırması gerekmez.
NVIDIA kimlik doğrulaması yapılandırıldığında OpenClaw, NVIDIA’nın herkese açık öne çıkan model kataloğunu tercih eder ve bunu 24 saat boyunca önbelleğe alır. Paketli geri dönüş kataloğu statiktir ve yükseltme uyumluluğu için kullanımdan kaldırılmış yayınlanmış ref’leri tutar. NVIDIA şu anda listelenen modeller için ücretsiz API erişimi sunduğundan maliyetler kaynakta varsayılan olarak 0 olur.
NVIDIA, standart /v1 completions endpoint’ini kullanır. OpenAI uyumlu tüm araçlar NVIDIA base URL’iyle kutudan çıktığı gibi çalışmalıdır.
NVIDIA’nın Ultra örnek isteği, akıl yürütme çıktısı için chat_template_kwargs.enable_thinking ve reasoning_budget kullanır. OpenClaw’ın paketli Ultra satırı, normal sohbet kullanımı için şablon düşünmeyi varsayılan olarak devre dışı bırakır. NVIDIA akıl yürütme çıktısına dahil olmanız veya NVIDIA’ya özgü diğer istek alanlarını zorlamanız gerekiyorsa, model başına parametreler ayarlayın ve sağlayıcıya özgü geçersiz kılmaları NVIDIA modeliyle sınırlı tutun:
{
  agents: {
    defaults: {
      models: {
        "nvidia/nvidia/nemotron-3-ultra-550b-a55b": {
          params: {
            chat_template_kwargs: { enable_thinking: true },
            extra_body: { reasoning_budget: 16384 },
          },
        },
      },
    },
  },
}
params.extra_body, son OpenAI uyumlu istek gövdesi geçersiz kılmasıdır; bu nedenle yalnızca NVIDIA’nın seçili endpoint için belgelediği alanlarda kullanın.
NVIDIA’da barındırılan bazı özel modeller, ilk yanıt parçasını yayınlamadan önce varsayılan model idle watchdog süresinden daha uzun sürebilir. Özel NVIDIA sağlayıcı girdileri için, tüm agent çalışma zamanı zaman aşımını yükseltmek yerine sağlayıcı zaman aşımını artırın:
{
  models: {
    providers: {
      "custom-integrate-api-nvidia-com": {
        baseUrl: "https://integrate.api.nvidia.com/v1",
        api: "openai-completions",
        apiKey: "NVIDIA_API_KEY",
        timeoutSeconds: 300,
      },
    },
  },
  agents: {
    defaults: {
      models: {
        "custom-integrate-api-nvidia-com/meta/llama-3.1-70b-instruct": {
          params: { thinking: "off" },
        },
      },
    },
  },
}
NVIDIA modelleri şu anda ücretsiz olarak kullanılabilir. En güncel kullanılabilirlik ve hız sınırı ayrıntıları için build.nvidia.com adresini kontrol edin.

​
İlgili

Model seçimi

Sağlayıcıları, model ref’lerini ve failover davranışını seçme.

Yapılandırma referansı

Ajanlar, modeller ve sağlayıcılar için tam yapılandırma referansı.