NVIDIA

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

بدء الاستخدام

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

أنشئ مفتاح API على build.nvidia.com.

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

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

تعيين نموذج NVIDIA

openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b

للإعداد غير التفاعلي، مرّر المفتاح مباشرةً:

openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."

يؤدي استخدام --nvidia-api-key إلى تسجيل المفتاح في سجل الصدفة ومخرجات ps. يُفضّل استخدام متغير البيئة NVIDIA_API_KEY متى أمكن.

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

{
  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، تجلب مسارات الإعداد واختيار النموذج كتالوج النماذج المميّزة العام من NVIDIA من https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json وتخزّن النتيجة مؤقتًا لمدة 24 ساعة (أول 32 إدخالًا، تُستورد كصفوف لإدخال النص المجاني). وبذلك تظهر النماذج المميّزة الجديدة من 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 النموذج كنقطة نهاية مجانية متاحة بمواصفات سياق يبلغ مليون رمز مميز. يرسل صف Ultra المضمّن chat_template_kwargs: { enable_thinking: false, force_nonempty_content: true } افتراضيًا، بحيث تبقى مخرجات المحادثة العادية في الإجابة المرئية بدلًا من إظهار نص الاستدلال. استخدم Ultra بوصفه خيار NVIDIA الافتراضي الأعلى قدرة. أبقِ Super محددًا عندما تريد خيار Nemotron 3 الأصغر، أو اختر أحد نماذج الجهات الخارجية المستضافة في كتالوج NVIDIA عندما يكون سياقها أو زمن استجابتها أو سلوكها أنسب.

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

تمثل الصفوف المضمّنة القابلة للاختيار لقطة من كتالوج النماذج المميّزة لدى NVIDIA. تظل صفوف التوافق المهملة قابلة للحل باستخدام المرجع الدقيق، لكنها لا تظهر في أدوات اختيار النماذج.

مرجع النموذج	الاسم	السياق	الحد الأقصى للمخرجات
`nvidia/nvidia/nemotron-3-ultra-550b-a55b`	Nemotron 3 Ultra 550B	1,048,576	8,192
`nvidia/nvidia/nemotron-3-super-120b-a12b`	Nemotron 3 Super 120B	1,000,000	8,192
`nvidia/z-ai/glm-5.2`	GLM 5.2	202,752	8,192
`nvidia/moonshotai/kimi-k2.6`	Kimi K2.6	262,144	8,192
`nvidia/minimaxai/minimax-m3`	Minimax M3	196,608	8,192
`nvidia/deepseek-ai/deepseek-v4-pro`	DeepSeek V4 Pro	262,144	16,384
`nvidia/qwen/qwen3.5-397b-a17b`	Qwen3.5 397B A17B	262,144	16,384

يحتفظ كتالوج التوافق الكامل أيضًا بهذه المراجع المنشورة للإعدادات الحالية: nvidia/moonshotai/kimi-k2.5 وnvidia/z-ai/glm-5.1 وnvidia/minimaxai/minimax-m2.5 وnvidia/z-ai/glm5 و nvidia/minimaxai/minimax-m2.7. تظل متاحة باستخدام المرجع الدقيق، لكنها لا تظهر مطلقًا في الإعداد الأولي أو أدوات اختيار النماذج.

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

سلوك التفعيل التلقائي

يُفعّل الموفّر تلقائيًا عند تعيين متغير البيئة NVIDIA_API_KEY أو عند تخزين مفتاح أثناء الإعداد الأولي. لا يلزم إعداد صريح للموفّر بخلاف المفتاح.

الكتالوج والتسعير

يفضّل OpenClaw كتالوج النماذج المميّزة العام لدى NVIDIA عند إعداد مصادقة NVIDIA، ويخزّنه مؤقتًا لمدة 24 ساعة. خيار الرجوع المضمّن القابل للاختيار هو لقطة ثابتة من كتالوج النماذج المميّزة لدى NVIDIA؛ وتُخفى صفوف التوافق المهملة ذات المراجعها الدقيقة من أدوات اختيار النماذج. تكون التكاليف افتراضيًا 0 في المصدر، لأن NVIDIA توفّر حاليًا وصولًا مجانيًا عبر API للنماذج المدرجة.

نقطة نهاية متوافقة مع OpenAI

يتواصل OpenClaw مع NVIDIA باستخدام محوّل openai-completions عبر مسار إكمال المحادثات القياسي /v1. يُفترض أن تعمل أي أداة متوافقة مع OpenAI مباشرةً باستخدام عنوان URL الأساسي لـ NVIDIA.

معلمات استدلال Nemotron 3 Ultra

يستخدم نموذج الطلب الخاص بـ 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.chat_template_kwargs محتواه في أي chat_template_kwargs موجودة مسبقًا في الطلب بدلًا من استبدال الكائن بالكامل. يمثّل params.extra_body التجاوز النهائي لجسم الطلب المتوافق مع OpenAI، ويستبدل مفاتيح الحمولة المتعارضة، لذا استخدمه فقط للحقول التي توثّقها NVIDIA لنقطة النهاية المحددة.

بطء استجابات الموفّر المخصص

قد تستغرق بعض النماذج المخصصة المستضافة لدى NVIDIA وقتًا أطول من مهلة مراقبة خمول النموذج الافتراضية البالغة نحو 120 ثانية قبل إصدار أول جزء من الاستجابة. بالنسبة إلى إدخالات موفّر NVIDIA المخصص، ارفع مهلة الموفّر بدلًا من مهلة وقت تشغيل الوكيل بالكامل؛ يغطي timeoutSeconds طلبات HTTP الخاصة بالموفّر ويرفع الحد الأقصى لمراقبة الخمول/البث لذلك الموفّر:

{
  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 للاطلاع على أحدث تفاصيل التوفر وحدود المعدّل.

ذو صلة

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

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

مرجع الإعداد

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

Overview

Concepts and configuration

Providers

بدء الاستخدام

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

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

Nemotron 3 Ultra

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

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

ذو صلة

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

مرجع الإعداد

​بدء الاستخدام

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

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

​Nemotron 3 Ultra

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

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

​ذو صلة

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

مرجع الإعداد

بدء الاستخدام

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

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

Nemotron 3 Ultra

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

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

ذو صلة