Providers

Qwen

يتعامل OpenClaw الآن مع Qwen بصفته Plugin مزوّدًا من الدرجة الأولى بالمعرّف القياسي qwen. يستهدف Plugin المزوّد نقاط نهاية Qwen Cloud / Alibaba DashScope و Coding Plan، ويحافظ على عمل معرّفات modelstudio القديمة كاسم مستعار للتوافق، ويكشف أيضًا تدفق رمز Qwen Portal كمزوّد qwen-oauth.

  • المزوّد: qwen
  • مزوّد البوابة: qwen-oauth
  • متغير البيئة المفضّل: QWEN_API_KEY
  • مقبول أيضًا للتوافق: MODELSTUDIO_API_KEY، DASHSCOPE_API_KEY
  • نمط API: متوافق مع OpenAI

تثبيت Plugin

ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway:

bash
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

البدء

اختر نوع خطتك واتبع خطوات الإعداد.

Coding Plan (subscription)

الأفضل لـ: الوصول القائم على الاشتراك عبر Qwen Coding Plan.

  • احصل على مفتاح API الخاص بك

    أنشئ مفتاح API أو انسخه من home.qwencloud.com/api-keys.

  • شغّل التهيئة الأولية

    لنقطة النهاية Global:

    bash
    openclaw onboard --auth-choice qwen-api-key

    لنقطة النهاية China:

    bash
    openclaw onboard --auth-choice qwen-api-key-cn
  • عيّن نموذجًا افتراضيًا

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • تحقق من توفر النموذج

    bash
    openclaw models list --provider qwen
  • Standard (pay-as-you-go)

    الأفضل لـ: الوصول بالدفع حسب الاستخدام عبر نقطة نهاية Standard Model Studio، بما في ذلك نماذج مثل qwen3.6-plus التي قد لا تكون متاحة في Coding Plan.

  • احصل على مفتاح API الخاص بك

    أنشئ مفتاح API أو انسخه من home.qwencloud.com/api-keys.

  • شغّل التهيئة الأولية

    لنقطة النهاية Global:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key

    لنقطة النهاية China:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key-cn
  • عيّن نموذجًا افتراضيًا

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • تحقق من توفر النموذج

    bash
    openclaw models list --provider qwen
  • Qwen OAuth / Portal

    الأفضل لـ: رمز Qwen Portal مقابل https://portal.qwen.ai/v1.

    راجع Qwen OAuth / Portal لصفحة المزوّد المخصصة وملاحظات الترحيل.

  • وفّر رمز البوابة الخاص بك

    bash
    openclaw onboard --auth-choice qwen-oauth
  • عيّن نموذجًا افتراضيًا

    json5
    {  agents: {    defaults: {      model: { primary: "qwen-oauth/qwen3.5-plus" },    },  },}
  • تحقق من توفر النموذج

    bash
    openclaw models list --provider qwen-oauth
  • أنواع الخطط ونقاط النهاية

    الخطة المنطقة اختيار المصادقة نقطة النهاية
    Standard (pay-as-you-go) China qwen-standard-api-key-cn dashscope.aliyuncs.com/compatible-mode/v1
    Standard (pay-as-you-go) Global qwen-standard-api-key dashscope-intl.aliyuncs.com/compatible-mode/v1
    Coding Plan (subscription) China qwen-api-key-cn coding.dashscope.aliyuncs.com/v1
    Coding Plan (subscription) Global qwen-api-key coding-intl.dashscope.aliyuncs.com/v1
    Qwen Portal Global qwen-oauth portal.qwen.ai/v1

    يختار المزوّد نقطة النهاية تلقائيًا بناءً على اختيار المصادقة. تستخدم الخيارات القياسية عائلة qwen-*؛ ويبقى modelstudio-* للتوافق فقط. يمكنك التجاوز باستخدام baseUrl مخصص في التكوين.

    الفهرس المدمج

    يشحن OpenClaw حاليًا هذا الفهرس الثابت لـ Qwen. الفهرس المكوّن واعٍ بنقطة النهاية: تكوينات Coding Plan تحذف النماذج المعروفة بأنها تعمل فقط على نقطة نهاية Standard.

    مرجع النموذج الإدخال السياق ملاحظات
    qwen/qwen3.5-plus نص، صورة 1,000,000 النموذج الافتراضي
    qwen/qwen3.6-plus نص، صورة 1,000,000 فضّل نقاط نهاية Standard عندما تحتاج إلى هذا النموذج
    qwen/qwen3-max-2026-01-23 نص 262,144 خط Qwen Max
    qwen/qwen3-coder-next نص 262,144 الترميز
    qwen/qwen3-coder-plus نص 1,000,000 الترميز
    qwen/MiniMax-M2.5 نص 1,000,000 التفكير مفعّل
    qwen/glm-5 نص 202,752 GLM
    qwen/glm-4.7 نص 202,752 GLM
    qwen/kimi-k2.5 نص، صورة 262,144 Moonshot AI عبر Alibaba
    qwen-oauth/qwen3.5-plus نص، صورة 1,000,000 افتراضي Qwen Portal

    عناصر التحكم في التفكير

    بالنسبة إلى نماذج Qwen Cloud الممكّنة للتفكير، يربط المزوّد مستويات تفكير OpenClaw بعلامة طلب DashScope العليا enable_thinking. يرسل تعطيل التفكير enable_thinking: false؛ وترسل مستويات التفكير الأخرى enable_thinking: true.

    إضافات متعددة الوسائط

    يكشف Plugin qwen أيضًا قدرات متعددة الوسائط على نقاط نهاية DashScope Standard (وليس نقاط نهاية Coding Plan):

    • فهم الفيديو عبر qwen-vl-max-latest
    • توليد فيديو Wan عبر wan2.6-t2v (الافتراضي)، wan2.6-i2v، wan2.6-r2v، wan2.6-r2v-flash، wan2.7-r2v

    لاستخدام Qwen كمزوّد الفيديو الافتراضي:

    json5
    {  agents: {    defaults: {      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },    },  },}

    التكوين المتقدم

    فهم الصور والفيديو

    يسجّل Plugin Qwen فهم الوسائط للصور والفيديو على نقاط نهاية DashScope Standard (وليس نقاط نهاية Coding Plan).

    الخاصية القيمة
    النموذج qwen-vl-max-latest
    الإدخال المدعوم صور، فيديو

    يتم حل فهم الوسائط تلقائيًا من مصادقة Qwen المكوّنة، ولا حاجة إلى تكوين إضافي. تأكد من أنك تستخدم نقطة نهاية Standard (pay-as-you-go) لدعم فهم الوسائط.

    توفر Qwen 3.6 Plus

    يتوفر qwen3.6-plus على نقاط نهاية Standard (pay-as-you-go) Model Studio:

    • China: dashscope.aliyuncs.com/compatible-mode/v1
    • Global: dashscope-intl.aliyuncs.com/compatible-mode/v1

    إذا أرجعت نقاط نهاية Coding Plan خطأ "نموذج غير مدعوم" لـ qwen3.6-plus، فانتقل إلى Standard (pay-as-you-go) بدلًا من زوج نقطة نهاية/مفتاح Coding Plan.

    لا يعلن فهرس Qwen الثابت في OpenClaw عن qwen3.6-plus على نقاط نهاية Coding Plan، لكن إدخالات qwen/qwen3.6-plus المكوّنة صراحة تحت models.providers.qwen.models تُحترم على baseUrls الخاصة بـ Coding Plan حتى يمكنك تفعيل ذلك النموذج إذا فعّلته Aliyun على اشتراكك. لا تزال API المنبع تقرر ما إذا كان الاستدعاء سينجح.

    خطة القدرات

    يجري وضع Plugin qwen ليكون موطن المورّد لكامل سطح Qwen Cloud، وليس فقط نماذج الترميز/النص.

    • نماذج النص/الدردشة: متاحة عبر Plugin
    • استدعاء الأدوات، والمخرجات المهيكلة، والتفكير: موروثة من النقل المتوافق مع OpenAI
    • توليد الصور: مخطط له في طبقة Plugin المزوّد
    • فهم الصور/الفيديو: متاح عبر Plugin على نقطة نهاية Standard
    • الكلام/الصوت: مخطط له في طبقة Plugin المزوّد
    • تضمينات الذاكرة/إعادة الترتيب: مخطط لها عبر سطح محوّل التضمين
    • توليد الفيديو: متاح عبر Plugin من خلال قدرة توليد الفيديو المشتركة
    تفاصيل توليد الفيديو

    بالنسبة إلى توليد الفيديو، يربط OpenClaw منطقة Qwen المكوّنة بمضيف DashScope AIGC المطابق قبل إرسال المهمة:

    • Global/Intl: https://dashscope-intl.aliyuncs.com
    • China: https://dashscope.aliyuncs.com

    يعني ذلك أن models.providers.qwen.baseUrl العادي الذي يشير إلى مضيفي Qwen سواء لـ Coding Plan أو Standard لا يزال يبقي توليد الفيديو على نقطة نهاية فيديو DashScope الإقليمية الصحيحة.

    حدود توليد الفيديو الحالية في Qwen:

    • حتى 1 فيديو ناتج لكل طلب
    • حتى 1 صورة إدخال
    • حتى 4 مقاطع فيديو إدخال
    • حتى مدة 10 ثوانٍ
    • يدعم size وaspectRatio وresolution وaudio وwatermark
    • يتطلب وضع صورة/فيديو المرجع حاليًا عناوين URL بعيدة http(s). تُرفض مسارات الملفات المحلية مقدمًا لأن نقطة نهاية فيديو DashScope لا تقبل مخازن الرفع المحلية لتلك المراجع.
    توافق استخدام البث

    تعلن نقاط نهاية Model Studio الأصلية عن توافق استخدام البث عبر ناقل openai-completions المشترك. يعتمد OpenClaw الآن في ذلك على قدرات نقطة النهاية، لذلك ترث معرفات المزوّد المخصص المتوافقة مع DashScope والموجّهة إلى المضيفين الأصليين أنفسهم سلوك استخدام البث نفسه بدلًا من اشتراط معرف المزوّد المضمّن qwen تحديدًا.

    ينطبق توافق استخدام البث الأصلي على كلٍّ من مضيفي Coding Plan ومضيفي DashScope القياسية المتوافقة:

    • https://coding.dashscope.aliyuncs.com/v1
    • https://coding-intl.dashscope.aliyuncs.com/v1
    • https://dashscope.aliyuncs.com/compatible-mode/v1
    • https://dashscope-intl.aliyuncs.com/compatible-mode/v1
    مناطق نقاط النهاية متعددة الوسائط

    تستخدم الأسطح متعددة الوسائط (فهم الفيديو وتوليد فيديو Wan) نقاط نهاية DashScope القياسية، وليس نقاط نهاية Coding Plan:

    • عنوان URL الأساسي القياسي العالمي/الدولي: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
    • عنوان URL الأساسي القياسي للصين: https://dashscope.aliyuncs.com/compatible-mode/v1
    إعداد البيئة والخدمة الخفية

    إذا كان Gateway يعمل كخدمة خفية (launchd/systemd)، فتأكد من أن QWEN_API_KEY متاح لتلك العملية (على سبيل المثال، في ~/.openclaw/.env أو عبر env.shellEnv).

    ذات صلة

    Was this useful?
    On this page

    On this page