الانتقال إلى المحتوى الرئيسي
يتعامل 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
إذا كنت تريد qwen3.6-plus، ففضّل نقطة نهاية Standard (pay-as-you-go). قد يتأخر دعم Coding Plan عن الفهرس العام.

​
تثبيت Plugin

ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway: 
openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

​
البدء

اختر نوع خطتك واتبع خطوات الإعداد.
الأفضل لـ: الوصول القائم على الاشتراك عبر Qwen Coding Plan.
1

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

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

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

لنقطة النهاية Global:
openclaw onboard --auth-choice qwen-api-key
لنقطة النهاية China:
openclaw onboard --auth-choice qwen-api-key-cn
3

عيّن نموذجًا افتراضيًا

{
  agents: {
    defaults: {
      model: { primary: "qwen/qwen3.5-plus" },
    },
  },
}
4

تحقق من توفر النموذج

openclaw models list --provider qwen
ما زالت معرّفات اختيار المصادقة القديمة modelstudio-* ومراجع النماذج modelstudio/... تعمل كأسماء مستعارة للتوافق، لكن تدفقات الإعداد الجديدة يجب أن تفضّل معرّفات اختيار المصادقة القياسية qwen-* ومراجع النماذج qwen/.... إذا عرّفت إدخال models.providers.modelstudio مخصصًا ودقيقًا بقيمة api أخرى، فإن ذلك المزوّد المخصص يملك مراجع modelstudio/... بدلًا من اسم توافق Qwen المستعار.

​
أنواع الخطط ونقاط النهاية

الخطةالمنطقةاختيار المصادقةنقطة النهاية
Standard (pay-as-you-go)Chinaqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard (pay-as-you-go)Globalqwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan (subscription)Chinaqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (subscription)Globalqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Qwen PortalGlobalqwen-oauthportal.qwen.ai/v1
يختار المزوّد نقطة النهاية تلقائيًا بناءً على اختيار المصادقة. تستخدم الخيارات القياسية عائلة qwen-*؛ ويبقى modelstudio-* للتوافق فقط. يمكنك التجاوز باستخدام baseUrl مخصص في التكوين.
إدارة المفاتيح: home.qwencloud.com/api-keys | الوثائق: docs.qwencloud.com

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

يشحن 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,752GLM
qwen/glm-4.7نص202,752GLM
qwen/kimi-k2.5نص، صورة262,144Moonshot 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 كمزوّد الفيديو الافتراضي: 
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
راجع توليد الفيديو لمعلمات الأداة المشتركة، واختيار المزوّد، وسلوك تجاوز الفشل.

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

يسجّل Plugin Qwen فهم الوسائط للصور والفيديو على نقاط نهاية DashScope Standard (وليس نقاط نهاية Coding Plan).
الخاصيةالقيمة
النموذجqwen-vl-max-latest
الإدخال المدعومصور، فيديو
يتم حل فهم الوسائط تلقائيًا من مصادقة Qwen المكوّنة، ولا حاجة إلى تكوين إضافي. تأكد من أنك تستخدم نقطة نهاية Standard (pay-as-you-go) لدعم فهم الوسائط.
يتوفر 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).

​
ذات صلة

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

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

توليد الفيديو

معلمات أداة الفيديو المشتركة واختيار المزوّد.

Alibaba (ModelStudio)

مزوّد ModelStudio القديم وملاحظات الترحيل.

استكشاف الأخطاء وإصلاحها

استكشاف الأخطاء وإصلاحها العام والأسئلة الشائعة.