Providers

Qwen

OpenClaw ตอนนี้ถือว่า Qwen เป็น Plugin ผู้ให้บริการระดับหลัก โดยมี id ตามแบบมาตรฐานคือ qwen Plugin ผู้ให้บริการนี้รองรับปลายทาง Qwen Cloud / Alibaba DashScope และ Coding Plan, ยังคงให้ id เดิม modelstudio ใช้งานได้ในฐานะนามแฝงเพื่อความเข้ากันได้ และยังเปิดให้ใช้โฟลว์โทเค็น Qwen Portal ในฐานะผู้ให้บริการ qwen-oauth ด้วย

  • ผู้ให้บริการ: qwen
  • ผู้ให้บริการ Portal: qwen-oauth
  • env var ที่แนะนำ: 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

  • Get your API key

    สร้างหรือคัดลอกคีย์ API จาก home.qwencloud.com/api-keys

  • Run onboarding

    สำหรับปลายทาง Global:

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

    สำหรับปลายทาง China:

    bash
    openclaw onboard --auth-choice qwen-api-key-cn
  • Set a default model

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verify the model is available

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

    เหมาะที่สุดสำหรับ: การเข้าถึงแบบจ่ายตามการใช้งานผ่านปลายทาง Standard Model Studio รวมถึงโมเดลอย่าง qwen3.6-plus ที่อาจไม่มีใน Coding Plan

  • Get your API key

    สร้างหรือคัดลอกคีย์ API จาก home.qwencloud.com/api-keys

  • Run onboarding

    สำหรับปลายทาง Global:

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

    สำหรับปลายทาง China:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key-cn
  • Set a default model

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • Verify the model is available

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

    เหมาะที่สุดสำหรับ: โทเค็น Qwen Portal ที่ใช้กับ https://portal.qwen.ai/v1

    ดู Qwen OAuth / Portal สำหรับหน้าผู้ให้บริการเฉพาะ และหมายเหตุการย้ายระบบ

  • Provide your portal token

    bash
    openclaw onboard --auth-choice qwen-oauth
  • Set a default model

    json5
    {  agents: {    defaults: {      model: { primary: "qwen-oauth/qwen3.5-plus" },    },  },}
  • Verify the model is available

    bash
    openclaw models list --provider qwen-oauth
  • ประเภทแผนและปลายทาง

    แผน ภูมิภาค ตัวเลือก Auth ปลายทาง
    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

    ผู้ให้บริการจะเลือกปลายทางโดยอัตโนมัติตามตัวเลือก auth ของคุณ ตัวเลือกตามแบบมาตรฐาน ใช้ตระกูล qwen-*; modelstudio-* เหลือไว้เพื่อความเข้ากันได้เท่านั้น คุณสามารถ override ด้วย baseUrl แบบกำหนดเองใน config ได้

    แค็ตตาล็อกในตัว

    ปัจจุบัน OpenClaw มาพร้อมแค็ตตาล็อกแบบคงที่ของ Qwen นี้ แค็ตตาล็อกที่กำหนดค่าไว้ รับรู้ปลายทาง: config ของ Coding Plan จะละเว้นโมเดลที่ทราบว่าใช้ได้เฉพาะบน ปลายทาง Standard

    Model ref อินพุต บริบท หมายเหตุ
    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

    การควบคุม Thinking

    สำหรับโมเดล Qwen Cloud ที่เปิดใช้งานการให้เหตุผล ผู้ให้บริการจะแมประดับ thinking ของ OpenClaw ไปยังแฟล็กคำขอระดับบนสุด enable_thinking ของ DashScope เมื่อปิดใช้ thinking จะส่ง enable_thinking: false; ระดับ thinking อื่นจะส่ง 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" },    },  },}

    การกำหนดค่าขั้นสูง

    Image and video understanding

    Plugin Qwen ลงทะเบียนการทำความเข้าใจสื่อสำหรับรูปภาพและวิดีโอ บนปลายทาง DashScope แบบ Standard (ไม่ใช่ปลายทาง Coding Plan)

    คุณสมบัติ ค่า
    โมเดล qwen-vl-max-latest
    อินพุตที่รองรับ รูปภาพ, วิดีโอ

    การทำความเข้าใจสื่อจะถูก resolve โดยอัตโนมัติจาก auth ของ Qwen ที่กำหนดค่าไว้ โดยไม่ต้องมี config เพิ่มเติม ตรวจสอบให้แน่ใจว่าคุณใช้ปลายทาง Standard (pay-as-you-go) เพื่อรองรับการทำความเข้าใจสื่อ

    Qwen 3.6 Plus availability

    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 ส่งคืนข้อผิดพลาด "unsupported model" สำหรับ 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 จะถูกใช้งานบน baseUrl ของ Coding Plan เพื่อให้คุณ เลือกใช้โมเดลนั้นได้หาก Aliyun เปิดใช้งานบนการสมัครสมาชิกของคุณ API ต้นทางยังคงเป็นผู้ตัดสินว่าการเรียกใช้งานจะสำเร็จหรือไม่

    Capability plan

    Plugin qwen กำลังถูกวางให้เป็นบ้านของผู้ขายสำหรับพื้นผิว Qwen Cloud แบบครบถ้วน ไม่ใช่แค่โมเดลเขียนโค้ด/ข้อความ

    • โมเดลข้อความ/แชต: พร้อมใช้งานผ่าน Plugin
    • การเรียกเครื่องมือ, เอาต์พุตแบบมีโครงสร้าง, thinking: สืบทอดจากทรานสปอร์ตที่เข้ากันได้กับ OpenAI
    • การสร้างรูปภาพ: วางแผนไว้ที่เลเยอร์ Plugin ผู้ให้บริการ
    • การทำความเข้าใจรูปภาพ/วิดีโอ: พร้อมใช้งานผ่าน Plugin บนปลายทาง Standard
    • เสียงพูด/เสียง: วางแผนไว้ที่เลเยอร์ Plugin ผู้ให้บริการ
    • การฝังหน่วยความจำ/การจัดอันดับใหม่: วางแผนผ่านพื้นผิวอะแดปเตอร์ embedding
    • การสร้างวิดีโอ: พร้อมใช้งานผ่าน Plugin ผ่านความสามารถการสร้างวิดีโอร่วม
    Video generation details

    สำหรับการสร้างวิดีโอ 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 อ้างอิงสิ่งนั้นจากความสามารถของปลายทาง ดังนั้น id ผู้ให้บริการแบบกำหนดเองที่เข้ากันได้กับ DashScope ซึ่งกำหนดเป้าหมายไปยังโฮสต์เนทีฟเดียวกัน จะสืบทอดลักษณะการทำงานด้านการใช้งานแบบสตรีมเดียวกัน แทนที่จะต้องใช้ id ผู้ให้บริการ 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 ฐานมาตรฐาน Global/Intl: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
    • URL ฐานมาตรฐานจีน: https://dashscope.aliyuncs.com/compatible-mode/v1
    การตั้งค่าสภาพแวดล้อมและ daemon

    หาก Gateway ทำงานเป็น daemon (launchd/systemd) ให้ตรวจสอบว่า QWEN_API_KEY พร้อมใช้งานสำหรับกระบวนการนั้น (เช่น ใน ~/.openclaw/.env หรือผ่าน env.shellEnv)

    ที่เกี่ยวข้อง

    Was this useful?
    On this page

    On this page