Chuyển đến nội dung chính
Qwen Cloud là plugin nhà cung cấp OpenClaw bên ngoài chính thức có id chuẩn qwen. Plugin này hướng đến các endpoint Standard và Coding Plan của Qwen Cloud / Alibaba DashScope, cung cấp Token Plan dưới dạng qwen-token-plan, giữ modelstudio làm bí danh tương thích và sở hữu độc lập id nhà cung cấp tùy chỉnh bailian-token-plan được Alibaba ghi nhận trong tài liệu.
qwen3.7-plus và qwen3.6-plus hoạt động với các endpoint Coding Plan và Standard. Đối với qwen3.7-max hoặc qwen3.6-flash, hãy sử dụng endpoint Standard (trả phí theo mức sử dụng).

​
Cài đặt plugin

qwen được phân phối dưới dạng plugin bên ngoài chính thức, không đi kèm với phần lõi. Hãy cài đặt plugin và khởi động lại Gateway:

​
Bắt đầu

Chọn loại gói và làm theo các bước thiết lập.
Phù hợp nhất cho: quyền truy cập dựa trên gói thuê bao thông qua Qwen Coding Plan.
1

Lấy khóa API

Tạo hoặc sao chép khóa API từ home.qwencloud.com/api-keys.
2

Chạy quy trình thiết lập ban đầu

Đối với endpoint Toàn cầu:
Đối với endpoint Trung Quốc:
3

Đặt mô hình mặc định

4

Xác minh mô hình khả dụng

Các id lựa chọn xác thực modelstudio-* cũ và tham chiếu mô hình modelstudio/... vẫn hoạt động dưới dạng bí danh tương thích, nhưng các luồng thiết lập mới nên ưu tiên các id lựa chọn xác thực qwen-* chuẩn và tham chiếu mô hình qwen/.... Nếu bạn định nghĩa chính xác một mục models.providers.modelstudio tùy chỉnh với giá trị api khác, nhà cung cấp tùy chỉnh đó sẽ sở hữu các tham chiếu modelstudio/... thay vì bí danh tương thích Qwen.

​
Các loại gói và endpoint

Nhà cung cấp tự động chọn endpoint dựa trên lựa chọn xác thực của bạn. Các lựa chọn chuẩn sử dụng họ qwen-*; modelstudio-* chỉ còn phục vụ mục đích tương thích. Ghi đè bằng baseUrl tùy chỉnh trong cấu hình.
Quản lý khóa: home.qwencloud.com/api-keys | Tài liệu: docs.qwencloud.com

​
Danh mục tích hợp sẵn

OpenClaw phân phối danh mục Qwen tĩnh này. Danh mục nhận biết endpoint: các cấu hình Coding Plan bỏ qua những mô hình chỉ hoạt động trên endpoint Standard.
Mức độ khả dụng vẫn có thể thay đổi tùy theo endpoint và gói thanh toán, ngay cả khi mô hình có trong danh mục tĩnh.

​
Danh mục Token Plan

Token Plan sử dụng danh sách cho phép riêng dựa trên chuỗi khớp chính xác. Các mô hình thuộc gói chỉ dành cho việc tạo hình ảnh không được đưa vào đây vì chúng sử dụng các API khác.

​
Điều khiển chế độ suy luận

qwen3.7-max, qwen3.7-plus, qwen3.6-flash và qwen3.6-plus được bật khả năng suy luận trong danh mục tích hợp sẵn. Đối với các mô hình suy luận thuộc họ qwen, nhà cung cấp ánh xạ các cấp độ suy luận của OpenClaw sang cờ yêu cầu cấp cao nhất enable_thinking của DashScope: khi tắt suy luận, hệ thống gửi enable_thinking: false, còn mọi cấp độ khác sẽ gửi enable_thinking: true. Các mô hình tùy chỉnh có thể chọn sử dụng payload suy luận theo mẫu trò chuyện thay thế bằng cách đặt compat.thinkingFormat: "qwen-chat-template" trên mục mô hình. Các mô hình Token Plan cũng được đánh dấu là có khả năng suy luận. kimi-k2.7-code và MiniMax-M2.5 chỉ hoạt động ở chế độ suy luận, vì vậy OpenClaw vẫn bật suy luận ngay cả khi phiên yêu cầu /think off. DeepSeek V4 ánh xạ từ minimal đến high sang mức nỗ lực high của dịch vụ và ánh xạ xhigh hoặc max sang max. GLM 5.2 chấp nhận toàn bộ phạm vi từ minimal đến max; GLM 5.1 và GLM 5 chấp nhận đến xhigh, và cả ba mặc định là high. Các mô hình lai khác tuân theo trạng thái bật/tắt được yêu cầu.

​
Tiện ích bổ sung đa phương thức

Plugin qwen cung cấp các khả năng đa phương thức chỉ trên các endpoint DashScope Standard, không cung cấp trên các endpoint Coding Plan:
  • Hiểu hình ảnh và video qua qwen3.6-plus
  • Tạo video bằng Wan qua wan2.6-t2v (mặc định), wan2.6-i2v, wan2.6-r2v, wan2.6-r2v-flash, wan2.7-r2v
Khả năng hiểu nội dung đa phương tiện được tự động phân giải từ thông tin xác thực Qwen đã cấu hình; không cần cấu hình bổ sung. Hãy đảm bảo bạn đang sử dụng endpoint Standard (trả phí theo mức sử dụng) để khả năng hiểu nội dung đa phương tiện hoạt động. Để đặt Qwen làm nhà cung cấp video mặc định:
Giới hạn tạo video: 1 video đầu ra cho mỗi yêu cầu, tối đa 1 hình ảnh đầu vào (chuyển hình ảnh thành video), tối đa 4 video đầu vào (chuyển video thành video), thời lượng tối đa 10 giây. Hỗ trợ size, aspectRatio, resolution, audio và watermark. Hình ảnh/video tham chiếu đầu vào yêu cầu URL http(s) từ xa; đường dẫn tệp cục bộ bị từ chối ngay từ đầu vì điểm cuối video DashScope không chấp nhận bộ đệm cục bộ đã tải lên cho các tham chiếu đó.
Xem Tạo video để biết các tham số công cụ dùng chung, cách chọn nhà cung cấp và hành vi chuyển đổi dự phòng.

​
Cấu hình nâng cao

qwen3.7-plus và qwen3.6-plus khả dụng trên các điểm cuối Coding Plan và Standard. qwen3.7-max và qwen3.6-flash chỉ khả dụng trên Standard. Các điểm cuối Standard (trả phí theo mức sử dụng) là:
  • Trung Quốc: dashscope.aliyuncs.com/compatible-mode/v1
  • Toàn cầu: dashscope-intl.aliyuncs.com/compatible-mode/v1
OpenClaw loại bỏ qwen3.7-max và qwen3.6-flash khỏi danh mục Coding Plan. Nếu một điểm cuối Coding Plan trả về lỗi “mô hình không được hỗ trợ” đối với một trong hai, hãy chuyển sang điểm cuối Standard tương ứng và khóa tương ứng.
OpenClaw ánh xạ khu vực Qwen đã cấu hình đến máy chủ AIGC DashScope tương ứng trước khi gửi tác vụ video:
  • Toàn cầu/Quốc tế: https://dashscope-intl.aliyuncs.com
  • Trung Quốc: https://dashscope.aliyuncs.com
Một models.providers.qwen.baseUrl thông thường trỏ đến máy chủ Qwen Coding Plan hoặc Standard vẫn định tuyến tác vụ tạo video đến điểm cuối video DashScope theo khu vực tương ứng.
Các điểm cuối Qwen gốc công bố khả năng tương thích sử dụng chế độ truyền trực tuyến trên phương thức truyền tải openai-completions dùng chung, vì vậy các mã định danh nhà cung cấp tùy chỉnh tương thích với DashScope nhắm đến cùng các máy chủ gốc sẽ kế thừa cùng hành vi mà không yêu cầu riêng mã định danh nhà cung cấp tích hợp sẵn qwen. Điều này áp dụng cho các điểm cuối Coding Plan, Standard và 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 đang được định vị là nơi tập trung phía nhà cung cấp cho toàn bộ bề mặt Qwen Cloud, không chỉ các mô hình lập trình/văn bản.
  • Mô hình văn bản/trò chuyện: khả dụng thông qua Plugin
  • Gọi công cụ, đầu ra có cấu trúc, suy luận: được kế thừa từ phương thức truyền tải tương thích với OpenAI
  • Tạo hình ảnh: được lên kế hoạch ở lớp Plugin nhà cung cấp
  • Hiểu hình ảnh/video: khả dụng thông qua Plugin trên điểm cuối Standard
  • Giọng nói/âm thanh: được lên kế hoạch ở lớp Plugin nhà cung cấp
  • Nhúng/xếp hạng lại bộ nhớ: được lên kế hoạch thông qua bề mặt bộ điều hợp nhúng
  • Tạo video: khả dụng thông qua Plugin nhờ khả năng tạo video dùng chung
Nếu Gateway chạy dưới dạng daemon (launchd/systemd), hãy đảm bảo QWEN_API_KEY hoặc QWEN_TOKEN_PLAN_API_KEY khả dụng cho tiến trình đó (ví dụ: trong ~/.openclaw/.env hoặc thông qua env.shellEnv).

​
Liên quan

Chọn mô hình

Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.

Tạo video

Các tham số công cụ video dùng chung và cách chọn nhà cung cấp.

Alibaba Model Studio

Nhà cung cấp tạo video Wan đi kèm trên cùng nền tảng DashScope.

Khắc phục sự cố

Hướng dẫn khắc phục sự cố chung và câu hỏi thường gặp.