Skip to main content

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 ไม่พร้อมใช้งานอีกต่อไป ดู Issue #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 (pay-as-you-go) เป็นหลัก การรองรับ Coding Plan อาจตามหลังแค็ตตาล็อกสาธารณะ

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

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

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

แผนภูมิภาคตัวเลือกการตรวจสอบสิทธิ์ปลายทาง
Standard (จ่ายตามการใช้งาน)Chinaqwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard (จ่ายตามการใช้งาน)Globalqwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan (การสมัครสมาชิก)Chinaqwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan (การสมัครสมาชิก)Globalqwen-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,000เปิดใช้การให้เหตุผล
qwen/glm-5ข้อความ202,752GLM
qwen/glm-4.7ข้อความ202,752GLM
qwen/kimi-k2.5ข้อความ, รูปภาพ262,144Moonshot 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 (จ่ายตามการใช้งาน) สำหรับการรองรับการทำความเข้าใจสื่อ
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 แบบเดิมและหมายเหตุการย้ายข้อมูล

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

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