الانتقال إلى المحتوى الرئيسي
توفّر NVIDIA واجهة API متوافقة مع OpenAI على https://integrate.api.nvidia.com/v1 للنماذج المفتوحة مجانًا. صادِق باستخدام مفتاح API من build.nvidia.com. يضبط OpenClaw موفّر NVIDIA افتراضيًا على Nemotron 3 Ultra، وهو نموذج الاستدلال النشط من NVIDIA بإجمالي 550B / نشط 55B لأعمال الوكلاء ذات السياق الطويل.

​
البدء

1

احصل على مفتاح API

أنشئ مفتاح API في build.nvidia.com.
2

صدّر المفتاح وشغّل الإعداد الأولي

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

عيّن نموذج NVIDIA

openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b
إذا مرّرت --nvidia-api-key بدلًا من متغير البيئة، فستظهر القيمة في سجل الصَدَفة ومخرجات ps. فضّل استخدام متغير البيئة NVIDIA_API_KEY عندما يكون ذلك ممكنًا.
للإعداد غير التفاعلي، يمكنك أيضًا تمرير المفتاح مباشرةً: 
openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."

​
مثال على الإعدادات

{
  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" },
    },
  },
}

​
الكتالوج المميّز

عند إعداد مفتاح API من NVIDIA، تحاول مسارات إعداد OpenClaw واختيار النماذج استخدام كتالوج النماذج المميّزة العام من NVIDIA من https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json وتخزّن النتيجة المرتبة مؤقتًا لمدة 24 ساعة. لذلك تظهر النماذج المميّزة الجديدة من build.nvidia.com في أسطح الإعداد واختيار النماذج دون انتظار إصدار OpenClaw. عندما تكون التغذية المباشرة متاحة، يكون أول نموذج مُعاد هو الخيار الافتراضي المعروض أثناء إعداد NVIDIA. يستخدم الجلب سياسة مضيف HTTPS ثابتة لـ assets.ngc.nvidia.com. إذا لم يكن مفتاح API من NVIDIA مُعدًا، أو إذا كان ذلك الكتالوج العام غير متاح أو سيئ التكوين، يعود OpenClaw إلى الكتالوج المضمّن والافتراضي المضمّن أدناه.

​
Nemotron 3 Ultra

Nemotron 3 Ultra هو نموذج NVIDIA الافتراضي في OpenClaw. تدرج صفحة البناء الخاصة بـ NVIDIA لـ nvidia/nemotron-3-ultra-550b-a55b أنه نقطة نهاية مجانية متاحة بمواصفة سياق قدرها 1M رمز مميّز. يسجّل الكتالوج المضمّن حدًا أقصى للمخرجات يبلغ 16,384 رمزًا مميّزًا لمطابقة طلب العينة الحالي المتوافق مع OpenAI من NVIDIA لنقطة النهاية المستضافة. استخدم Ultra للحصول على افتراضي NVIDIA الأعلى قدرة. أبقِ Super محددًا عندما تريد خيار Nemotron 3 الأصغر، أو اختر أحد نماذج الجهات الخارجية المستضافة في كتالوج NVIDIA عندما يكون سياقه أو زمن استجابته أو سلوكه أنسب. يرسل صف Ultra المضمّن chat_template_kwargs.enable_thinking: false وforce_nonempty_content: true افتراضيًا بحيث تبقى مخرجات الدردشة العادية في الإجابة المرئية بدلًا من كشف نص الاستدلال.

​
كتالوج الرجوع المضمّن

مرجع النموذجالاسمالسياقالحد الأقصى للمخرجاتملاحظات
nvidia/nvidia/nemotron-3-ultra-550b-a55bNVIDIA Nemotron 3 Ultra 550B1,000,00016,384الافتراضي
nvidia/nvidia/nemotron-3-super-120b-a12bNVIDIA Nemotron 3 Super 120B1,048,5768,192رجوع مميّز
nvidia/moonshotai/kimi-k2.5Kimi K2.5262,1448,192رجوع مميّز
nvidia/minimaxai/minimax-m2.7Minimax M2.7196,6088,192رجوع مميّز
nvidia/z-ai/glm-5.1GLM 5.1202,7528,192رجوع مميّز
nvidia/minimaxai/minimax-m2.5MiniMax M2.5196,6088,192مهمل، توافق الترقية
nvidia/z-ai/glm5GLM-5202,7528,192مهمل، توافق الترقية

​
الإعدادات المتقدمة

يتفعّل الموفّر تلقائيًا عند تعيين متغير البيئة NVIDIA_API_KEY. لا يلزم إعداد موفّر صريح بخلاف المفتاح.
يفضّل OpenClaw كتالوج النماذج المميّزة العام من NVIDIA عندما تكون مصادقة NVIDIA مُعدّة، ويخزّنه مؤقتًا لمدة 24 ساعة. كتالوج الرجوع المضمّن ثابت ويحتفظ بالمراجع المشحونة المهملة لتوافق الترقية. تكون التكاليف افتراضيًا 0 في المصدر لأن NVIDIA توفّر حاليًا وصول API مجانيًا للنماذج المدرجة.
تستخدم NVIDIA نقطة نهاية الإكمال القياسية /v1. يجب أن تعمل أي أدوات متوافقة مع OpenAI مباشرةً باستخدام عنوان URL الأساسي من NVIDIA.
يستخدم طلب عينة Ultra من NVIDIA chat_template_kwargs.enable_thinking وreasoning_budget لمخرجات الاستدلال. يعطّل صف Ultra المضمّن في OpenClaw التفكير عبر القالب افتراضيًا لاستخدام الدردشة العادي. إذا احتجت إلى الاشتراك في مخرجات الاستدلال من NVIDIA أو فرض حقول طلب أخرى خاصة بـ NVIDIA، فعيّن معاملات لكل نموذج وأبقِ التجاوزات الخاصة بالموفّر محصورة في نموذج NVIDIA:
{
  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 هو تجاوز جسم الطلب النهائي المتوافق مع OpenAI، لذا استخدمه فقط للحقول التي توثقها NVIDIA لنقطة النهاية المحددة.
قد تستغرق بعض النماذج المخصصة المستضافة لدى NVIDIA وقتًا أطول من مراقب خمول النموذج الافتراضي قبل أن تُصدر أول جزء من الاستجابة. لإدخالات موفّر NVIDIA المخصص، ارفع مهلة الموفّر بدلًا من رفع مهلة تشغيل الوكيل بالكامل:
{
  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 مجانية الاستخدام حاليًا. راجع build.nvidia.com للحصول على أحدث تفاصيل التوفر وحدود المعدلات.

​
ذات صلة

اختيار النموذج

اختيار الموفّرين ومراجع النماذج وسلوك تجاوز الفشل.

مرجع الإعدادات

مرجع الإعدادات الكامل للوكلاء والنماذج والموفّرين.