Providers

Qwen

Qwen Cloud یک Plugin رسمی و خارجی برای ارائه‌دهنده OpenClaw با شناسهٔ استاندارد qwen است. این Plugin نقاط پایانی Standard و Coding Plan در Qwen Cloud / Alibaba DashScope را هدف قرار می‌دهد، Token Plan را با نام qwen-token-plan ارائه می‌کند، modelstudio را به‌عنوان نام مستعار سازگاری نگه می‌دارد، مستقلاً مالک شناسهٔ ارائه‌دهندهٔ سفارشی bailian-token-plan مستندشده توسط Alibaba است و جریان توکن Qwen Portal را با نام qwen-oauth ارائه می‌کند.

ویژگی مقدار
ارائه‌دهنده qwen
ارائه‌دهندهٔ Token Plan qwen-token-plan
ارائه‌دهندهٔ Portal qwen-oauth
متغیر محیطی ترجیحی QWEN_API_KEY
متغیر محیطی Token Plan QWEN_TOKEN_PLAN_API_KEY
موارد پذیرفته‌شدهٔ دیگر (سازگاری) MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
سبک API سازگار با OpenAI

نصب Plugin

qwen به‌صورت یک Plugin رسمی و خارجی عرضه می‌شود و همراه هسته نیست. آن را نصب و Gateway را راه‌اندازی مجدد کنید:

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

شروع به کار

نوع طرح خود را انتخاب و مراحل راه‌اندازی را دنبال کنید.

Coding Plan (اشتراکی)

مناسب برای: دسترسی مبتنی بر اشتراک از طریق Qwen Coding Plan.

  • دریافت کلید API

    یک کلید API در home.qwencloud.com/api-keys ایجاد یا از آنجا کپی کنید.

  • اجرای راه‌اندازی اولیه

    برای نقطهٔ پایانی سراسری:

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

    برای نقطهٔ پایانی چین:

    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 (پرداخت به‌ازای مصرف)

    مناسب برای: دسترسی پرداخت به‌ازای مصرف از طریق نقطهٔ پایانی Standard در Model Studio، شامل qwen3.7-max و qwen3.6-flash که در Coding Plan در دسترس نیستند.

  • دریافت کلید API

    یک کلید API در home.qwencloud.com/api-keys ایجاد یا از آنجا کپی کنید.

  • اجرای راه‌اندازی اولیه

    برای نقطهٔ پایانی سراسری:

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

    برای نقطهٔ پایانی چین:

    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
  • Token Plan (نسخهٔ تیمی)

    مناسب برای: دسترسی اشتراکی تیمی مبتنی بر اعتبار به Qwen و مدل‌های شخص ثالث پشتیبانی‌شده از طریق Alibaba Cloud Model Studio.

  • دریافت کلید اختصاصی

    یک جایگاه Token Plan اختصاص دهید و کلید اختصاصی sk-sp-... آن را ایجاد کنید. کلیدهای Token Plan،‏ Coding Plan و پرداخت به‌ازای مصرف قابل جایگزینی با یکدیگر نیستند. به نمای کلی Token Plan سراسری یا نمای کلی Token Plan چین مراجعه کنید.

  • اجرای راه‌اندازی اولیه

    برای نقطهٔ پایانی سراسری / بین‌المللی در سنگاپور:

    bash
    openclaw onboard --auth-choice qwen-token-plan

    برای نقطهٔ پایانی چین در پکن:

    bash
    openclaw onboard --auth-choice qwen-token-plan-cn
  • بررسی ارائه‌دهنده

    bash
    openclaw models list --provider qwen-token-planopenclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready"
  • Qwen OAuth / Portal

    مناسب برای: استفاده از توکن Qwen Portal در برابر https://portal.qwen.ai/v1.

    برای صفحهٔ اختصاصی ارائه‌دهنده و یادداشت‌های مهاجرت، به Qwen OAuth / Portal مراجعه کنید.

  • ارائهٔ توکن 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
  • انواع طرح و نقاط پایانی

    طرح منطقه انتخاب احراز هویت نقطهٔ پایانی
    Coding Plan (اشتراکی) چین qwen-api-key-cn coding.dashscope.aliyuncs.com/v1
    Coding Plan (اشتراکی) سراسری qwen-api-key coding-intl.dashscope.aliyuncs.com/v1
    Qwen Portal سراسری qwen-oauth portal.qwen.ai/v1
    Standard (پرداخت به‌ازای مصرف) چین qwen-standard-api-key-cn dashscope.aliyuncs.com/compatible-mode/v1
    Standard (پرداخت به‌ازای مصرف) سراسری qwen-standard-api-key dashscope-intl.aliyuncs.com/compatible-mode/v1
    Token Plan (نسخهٔ تیمی) چین qwen-token-plan-cn token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    Token Plan (نسخهٔ تیمی) سراسری qwen-token-plan token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

    ارائه‌دهنده بر اساس انتخاب احراز هویت شما، نقطهٔ پایانی را به‌طور خودکار انتخاب می‌کند. انتخاب‌های استاندارد از خانوادهٔ qwen-* استفاده می‌کنند؛ modelstudio-* فقط برای سازگاری باقی مانده است. برای بازنویسی این رفتار، یک baseUrl سفارشی در پیکربندی تعیین کنید.

    کاتالوگ داخلی

    OpenClaw این کاتالوگ ایستای Qwen را ارائه می‌کند. کاتالوگ از نقطهٔ پایانی آگاه است: پیکربندی‌های Coding Plan مدل‌هایی را که فقط در نقطهٔ پایانی Standard کار می‌کنند، حذف می‌کنند.

    ارجاع مدل ورودی زمینه یادداشت‌ها
    qwen/qwen3.5-plus متن، تصویر 1,000,000 مدل پیش‌فرض
    qwen/qwen3.6-flash متن، تصویر 1,000,000 فقط نقاط پایانی Standard
    qwen/qwen3.6-plus متن، تصویر 1,000,000 Coding Plan و Standard
    qwen/qwen3.7-max متن 1,000,000 فقط نقاط پایانی Standard
    qwen/qwen3.7-plus متن، تصویر 1,000,000 Coding Plan و 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

    کاتالوگ Token Plan

    Token Plan از یک فهرست مجاز جداگانه با تطبیق دقیق رشته استفاده می‌کند. مدل‌های طرح که فقط برای تولید تصویر هستند، در اینجا گنجانده نشده‌اند، زیرا از APIهای متفاوتی استفاده می‌کنند.

    ارجاع مدل ورودی زمینه
    qwen-token-plan/qwen3.7-max متن 1,000,000
    qwen-token-plan/qwen3.7-plus متن، تصویر 1,000,000
    qwen-token-plan/qwen3.6-plus متن، تصویر 1,000,000
    qwen-token-plan/qwen3.6-flash متن، تصویر 1,000,000
    qwen-token-plan/deepseek-v4-pro متن 1,000,000
    qwen-token-plan/deepseek-v4-flash متن 1,000,000
    qwen-token-plan/deepseek-v3.2 متن 131,072
    qwen-token-plan/kimi-k2.7-code متن، تصویر 262,144
    qwen-token-plan/kimi-k2.6 متن، تصویر 262,144
    qwen-token-plan/kimi-k2.5 متن، تصویر 262,144
    qwen-token-plan/glm-5.2 متن 1,000,000
    qwen-token-plan/glm-5.1 متن 202,752
    qwen-token-plan/glm-5 متن 202,752
    qwen-token-plan/MiniMax-M2.5 متن 196,608

    کنترل‌های تفکر

    qwen3.7-max، qwen3.7-plus، qwen3.6-flash و qwen3.6-plus در فهرست داخلی از قابلیت استدلال برخوردارند. برای مدل‌های استدلالی خانوادهٔ qwen، ارائه‌دهنده سطوح تفکر OpenClaw را به پرچم سطح‌بالای enable_thinking در درخواست DashScope نگاشت می‌کند: در حالت تفکر غیرفعال، enable_thinking: false ارسال می‌شود و در هر سطح دیگری، enable_thinking: true ارسال می‌شود. مدل‌های سفارشی می‌توانند با تنظیم compat.thinkingFormat: "qwen-chat-template" در ورودی مدل، محمولهٔ جایگزین تفکر مبتنی بر قالب چت را فعال کنند.

    مدل‌های Token Plan نیز دارای قابلیت استدلال علامت‌گذاری شده‌اند. kimi-k2.7-code و MiniMax-M2.5 فقط در حالت تفکر کار می‌کنند؛ بنابراین OpenClaw حتی زمانی که نشست /think off را درخواست می‌کند، تفکر را فعال نگه می‌دارد. DeepSeek V4 سطوح minimal تا high را به میزان تلاش high سرویس و xhigh یا max را به max نگاشت می‌کند. GLM 5.2 دامنهٔ کامل minimal تا max را می‌پذیرد؛ GLM 5.1 و GLM 5 تا xhigh را می‌پذیرند و مقدار پیش‌فرض هر سه high است. سایر مدل‌های ترکیبی از وضعیت روشن/خاموش درخواستی پیروی می‌کنند.

    افزونه‌های چندوجهی

    Plugin مربوط به qwen قابلیت‌های چندوجهی را فقط در نقطه‌های پایانی استاندارد DashScope ارائه می‌کند، نه در نقطه‌های پایانی Coding Plan:

    • درک تصویر و ویدئو از طریق qwen-vl-max-latest
    • تولید ویدئوی Wan از طریق wan2.6-t2v (پیش‌فرض)، wan2.6-i2v، wan2.6-r2v، wan2.6-r2v-flash، wan2.7-r2v

    احراز هویت درک رسانه به‌طور خودکار از احراز هویت پیکربندی‌شدهٔ Qwen استخراج می‌شود و به پیکربندی اضافی نیازی نیست. برای کارکرد درک رسانه، مطمئن شوید که از یک نقطهٔ پایانی استاندارد (پرداخت به‌ازای مصرف) استفاده می‌کنید.

    برای تعیین Qwen به‌عنوان ارائه‌دهندهٔ پیش‌فرض ویدئو:

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

    محدودیت‌های تولید ویدئو: در هر درخواست ۱ ویدئوی خروجی، حداکثر ۱ تصویر ورودی (تبدیل تصویر به ویدئو)، حداکثر ۴ ویدئوی ورودی (تبدیل ویدئو به ویدئو) و حداکثر مدت ۱۰ ثانیه. از size، aspectRatio، resolution، audio و watermark پشتیبانی می‌شود. ورودی‌های تصویر/ویدئوی مرجع باید URLهای راه‌دور http(s) باشند؛ مسیرهای فایل محلی از ابتدا رد می‌شوند، زیرا نقطهٔ پایانی ویدئوی DashScope بافرهای محلی بارگذاری‌شده را برای این مراجع نمی‌پذیرد.

    پیکربندی پیشرفته

    دسترس‌پذیری Qwen 3.6 و 3.7

    qwen3.7-plus و qwen3.6-plus در نقطه‌های پایانی Coding Plan و استاندارد در دسترس‌اند. qwen3.7-max و qwen3.6-flash فقط در نقطه‌های پایانی استاندارد در دسترس‌اند. نقطه‌های پایانی استاندارد (پرداخت به‌ازای مصرف) عبارت‌اند از:

    • چین: dashscope.aliyuncs.com/compatible-mode/v1
    • جهانی: dashscope-intl.aliyuncs.com/compatible-mode/v1

    OpenClaw مدل‌های qwen3.7-max و qwen3.6-flash را در فهرست‌های Coding Plan قرار نمی‌دهد. اگر یک نقطهٔ پایانی Coding Plan برای هرکدام خطای «مدل پشتیبانی‌نشده» برگرداند، از نقطهٔ پایانی استاندارد و کلید متناظر استفاده کنید.

    مسیریابی منطقه‌ای تولید ویدئو

    OpenClaw پیش از ارسال یک کار تولید ویدئو، منطقهٔ پیکربندی‌شدهٔ Qwen را به میزبان متناظر AIGC در DashScope نگاشت می‌کند:

    • جهانی/بین‌المللی: https://dashscope-intl.aliyuncs.com
    • چین: https://dashscope.aliyuncs.com

    یک models.providers.qwen.baseUrl معمولی که به میزبان‌های Coding Plan یا استاندارد Qwen اشاره می‌کند، همچنان تولید ویدئو را به نقطهٔ پایانی منطقه‌ای متناظر ویدئوی DashScope هدایت می‌کند.

    سازگاری مصرف در پخش جریانی

    نقطه‌های پایانی بومی Qwen سازگاری مصرف در پخش جریانی را روی انتقال مشترک openai-completions اعلام می‌کنند؛ بنابراین شناسه‌های سفارشی ارائه‌دهندهٔ سازگار با DashScope که همان میزبان‌های بومی را هدف می‌گیرند، بدون نیاز اختصاصی به شناسهٔ ارائه‌دهندهٔ داخلی qwen، همان رفتار را به ارث می‌برند. این موضوع برای نقطه‌های پایانی Coding Plan، استاندارد و Token Plan صدق می‌کند:

    • 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
    • https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
    • https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    برنامهٔ قابلیت‌ها

    Plugin مربوط به qwen در حال تبدیل‌شدن به جایگاه اصلی فروشنده برای کل مجموعهٔ قابلیت‌های Qwen Cloud است، نه فقط مدل‌های کدنویسی/متن.

    • مدل‌های متن/چت: از طریق Plugin در دسترس‌اند
    • فراخوانی ابزار، خروجی ساخت‌یافته، تفکر: از انتقال سازگار با OpenAI به ارث می‌رسند
    • تولید تصویر: برای لایهٔ Plugin ارائه‌دهنده برنامه‌ریزی شده است
    • درک تصویر/ویدئو: از طریق Plugin در نقطهٔ پایانی استاندارد در دسترس است
    • گفتار/صدا: برای لایهٔ Plugin ارائه‌دهنده برنامه‌ریزی شده است
    • تعبیه‌سازی/بازرتبه‌بندی حافظه: برای سطح آداپتور تعبیه‌سازی برنامه‌ریزی شده است
    • تولید ویدئو: از طریق Plugin و قابلیت مشترک تولید ویدئو در دسترس است
    راه‌اندازی محیط و دیمن

    اگر Gateway به‌صورت دیمن (launchd/systemd) اجرا می‌شود، مطمئن شوید QWEN_API_KEY یا QWEN_TOKEN_PLAN_API_KEY برای آن فرایند در دسترس است (برای مثال، در ~/.openclaw/.env یا از طریق env.shellEnv).

    مرتبط

    Was this useful?
    On this page

    On this page