Providers

Qwen

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

ผู้ให้บริการ: qwen
ตัวแปรสภาพแวดล้อมที่แนะนำ: QWEN_API_KEY
ยอมรับเพื่อความเข้ากันได้ด้วย: MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
รูปแบบ API: เข้ากันได้กับ OpenAI

เริ่มต้นใช้งาน

เลือกประเภทแผนของคุณและทำตามขั้นตอนการตั้งค่า

Coding Plan (การสมัครสมาชิก)

เหมาะที่สุดสำหรับ: การเข้าถึงแบบสมัครสมาชิกผ่าน Qwen Coding Plan

รับคีย์ API ของคุณ

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

เรียกใช้การเริ่มต้นใช้งาน

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

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

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

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

ตั้งค่าโมเดลเริ่มต้น

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

ตรวจสอบว่าโมเดลพร้อมใช้งาน

openclaw models list --provider qwen

Note

รหัส auth-choice เดิม modelstudio-* และการอ้างอิงโมเดล modelstudio/... ยังคง ใช้งานได้ในฐานะนามแฝงเพื่อความเข้ากันได้ แต่โฟลว์การตั้งค่าใหม่ควรใช้รหัส auth-choice มาตรฐาน qwen-* และการอ้างอิงโมเดล qwen/... เป็นหลัก หากคุณกำหนดรายการ models.providers.modelstudio แบบกำหนดเองที่ตรงทั้งหมดพร้อมค่า api อื่น ผู้ให้บริการแบบกำหนดเองนั้นจะเป็นเจ้าของการอ้างอิง modelstudio/... แทนนามแฝงเพื่อความเข้ากันได้ของ Qwen

Standard (จ่ายตามการใช้งาน)

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

รับคีย์ API ของคุณ

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

เรียกใช้การเริ่มต้นใช้งาน

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

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

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

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

ตั้งค่าโมเดลเริ่มต้น

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

ตรวจสอบว่าโมเดลพร้อมใช้งาน

openclaw models list --provider qwen

Note

ประเภทแผนและปลายทาง

แผน	ภูมิภาค	ตัวเลือกการตรวจสอบสิทธิ์	ปลายทาง
Standard (จ่ายตามการใช้งาน)	China	`qwen-standard-api-key-cn`	`dashscope.aliyuncs.com/compatible-mode/v1`
Standard (จ่ายตามการใช้งาน)	Global	`qwen-standard-api-key`	`dashscope-intl.aliyuncs.com/compatible-mode/v1`
Coding Plan (การสมัครสมาชิก)	China	`qwen-api-key-cn`	`coding.dashscope.aliyuncs.com/v1`
Coding Plan (การสมัครสมาชิก)	Global	`qwen-api-key`	`coding-intl.dashscope.aliyuncs.com/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 Cloud ที่เปิดใช้การให้เหตุผล ผู้ให้บริการแบบบันเดิลจะจับคู่ระดับ การคิดของ 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 (จ่ายตามการใช้งาน) สำหรับการรองรับการทำความเข้าใจสื่อ

ความพร้อมใช้งานของ Qwen 3.6 Plus

qwen3.6-plus พร้อมใช้งานบนปลายทาง Standard (จ่ายตามการใช้งาน) 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 (จ่ายตามการใช้งาน) แทนคู่ปลายทาง/คีย์ ของ Coding Plan

แค็ตตาล็อก Qwen แบบบันเดิลของ OpenClaw ไม่ประกาศ qwen3.6-plus บนปลายทาง Coding Plan แต่รายการ qwen/qwen3.6-plus ที่กำหนดค่าไว้อย่างชัดเจนภายใต้ models.providers.qwen.models จะได้รับการเคารพบน baseUrl ของ Coding Plan เพื่อให้คุณ เลือกใช้โมเดลนั้นได้หาก Aliyun เปิดใช้งานให้กับการสมัครสมาชิกของคุณ API ต้นทางยังคงเป็นผู้ตัดสินใจว่าการเรียกจะสำเร็จหรือไม่

แผนความสามารถ

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

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

รายละเอียดการสร้างวิดีโอ

สำหรับการสร้างวิดีโอ 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 และ โฮสต์ที่เข้ากันได้กับ 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 ของ Global/Intl: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
URL ฐาน Standard ของ China: https://dashscope.aliyuncs.com/compatible-mode/v1

การตั้งค่าสภาพแวดล้อมและดีมอน

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

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

การเลือกโมเดล

การเลือกผู้ให้บริการ การอ้างอิงโมเดล และพฤติกรรมการสลับไปใช้ตัวสำรอง

การสร้างวิดีโอ

พารามิเตอร์เครื่องมือวิดีโอที่ใช้ร่วมกันและการเลือกผู้ให้บริการ

Alibaba (ModelStudio)

ผู้ให้บริการ ModelStudio แบบเดิมและหมายเหตุการย้ายข้อมูล

การแก้ไขปัญหา

การแก้ไขปัญหาทั่วไปและคำถามที่พบบ่อย

# เริ่มต้นใช้งาน

Coding Plan (การสมัครสมาชิก)

รับคีย์ API ของคุณ

เรียกใช้การเริ่มต้นใช้งาน

ตั้งค่าโมเดลเริ่มต้น

ตรวจสอบว่าโมเดลพร้อมใช้งาน

Standard (จ่ายตามการใช้งาน)

รับคีย์ API ของคุณ

เรียกใช้การเริ่มต้นใช้งาน

ตั้งค่าโมเดลเริ่มต้น

ตรวจสอบว่าโมเดลพร้อมใช้งาน

# ประเภทแผนและปลายทาง

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

# การควบคุมการคิด

# ส่วนเสริมมัลติโหมด

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

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

เริ่มต้นใช้งาน

ประเภทแผนและปลายทาง

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

การควบคุมการคิด

ส่วนเสริมมัลติโหมด

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

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