الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

تمت إزالة Qwen OAuth. لم يعد تكامل OAuth للطبقة المجانية (qwen-portal) الذي كان يستخدم نقاط نهاية portal.qwen.ai متاحًا. راجع المشكلة #49557 للاطلاع على الخلفية.
يتعامل OpenClaw الآن مع Qwen كمزوّد مضمّن من الدرجة الأولى بالمعرّف الأساسي qwen. يستهدف المزوّد المضمّن نقاط نهاية Qwen Cloud / Alibaba DashScope و Coding Plan، ويُبقي معرّفات modelstudio القديمة عاملة كاسم مستعار للتوافق.
  • المزوّد: qwen
  • متغير البيئة المفضّل: QWEN_API_KEY
  • مقبول أيضًا للتوافق: MODELSTUDIO_API_KEY، DASHSCOPE_API_KEY
  • نمط API: متوافق مع OpenAI
إذا كنت تريد qwen3.6-plus، ففضّل نقطة نهاية Standard (الدفع حسب الاستخدام). قد يتأخر دعم Coding Plan عن الفهرس العام.

​
البدء

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

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

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

شغّل الإعداد الأولي

لنقطة النهاية العالمية:
openclaw onboard --auth-choice qwen-api-key
لنقطة النهاية الصينية:
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 (الدفع حسب الاستخدام)الصينqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard (الدفع حسب الاستخدام)عالميqwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan (اشتراك)الصينqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (اشتراك)عالميqwen-api-keycoding-intl.dashscope.aliyuncs.com/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,000Reasoning مفعّل
qwen/glm-5نص202,752GLM
qwen/glm-4.7نص202,752GLM
qwen/kimi-k2.5نص، صورة262,144Moonshot AI عبر Alibaba
قد يظل التوفر مختلفًا حسب نقطة النهاية وخطة الفوترة حتى عندما يكون النموذج موجودًا في الفهرس المضمّن.

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

بالنسبة إلى نماذج Qwen Cloud المفعّل فيها Reasoning، يربط المزوّد المضمّن مستويات التفكير في OpenClaw بعلم الطلب العلوي enable_thinking في DashScope. يرسل تعطيل التفكير 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 (الدفع حسب الاستخدام) لدعم فهم الوسائط.
يتوفر qwen3.6-plus على نقاط نهاية Standard (الدفع حسب الاستخدام) في Model Studio:
  • الصين: dashscope.aliyuncs.com/compatible-mode/v1
  • عالمي: dashscope-intl.aliyuncs.com/compatible-mode/v1
إذا أعادت نقاط نهاية Coding Plan خطأ “نموذج غير مدعوم” لـ qwen3.6-plus، فانتقل إلى Standard (الدفع حسب الاستخدام) بدلًا من زوج نقطة النهاية/المفتاح الخاص بـ 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 الكامل، وليس فقط نماذج البرمجة/النص.
  • نماذج النص/الدردشة: مضمّنة الآن
  • استدعاء الأدوات، والمخرجات المنظمة، والتفكير: موروثة من النقل المتوافق مع OpenAI
  • توليد الصور: مخطط له على طبقة provider-plugin
  • فهم الصور/الفيديو: مضمّن الآن على نقطة نهاية Standard
  • الكلام/الصوت: مخطط له على طبقة provider-plugin
  • تضمينات الذاكرة/إعادة الترتيب: مخطط لها عبر سطح محول التضمين
  • توليد الفيديو: مضمّن الآن عبر قدرة توليد الفيديو المشتركة
بالنسبة إلى توليد الفيديو، يربط OpenClaw منطقة Qwen المضبوطة بمضيف DashScope AIGC المطابق قبل إرسال المهمة:
  • عالمي/دولي: https://dashscope-intl.aliyuncs.com
  • الصين: 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 وعلى المضيفين المتوافقين مع Standard 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 Standard، وليس نقاط نهاية Coding Plan:
  • عنوان URL الأساسي العالمي/الدولي لـ Standard: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • عنوان URL الأساسي الصيني لـ Standard: https://dashscope.aliyuncs.com/compatible-mode/v1
إذا كان Gateway يعمل كبرنامج خفي (launchd/systemd)، فتأكد من أن QWEN_API_KEY متاح لذلك process (على سبيل المثال، في ~/.openclaw/.env أو عبر env.shellEnv).

​
ذات صلة

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

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

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

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

Alibaba (ModelStudio)

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

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

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