Providers
Alibaba Model Studio
OpenClaw cung cấp sẵn một Plugin alibaba đăng ký nhà cung cấp tạo video cho các mô hình Wan trên Alibaba Model Studio (tên quốc tế của DashScope). Plugin này được bật theo mặc định; bạn chỉ cần đặt API key.
| Thuộc tính | Giá trị |
|---|---|
| ID nhà cung cấp | alibaba |
| Plugin | đi kèm, enabledByDefault: true |
| Biến môi trường xác thực | MODELSTUDIO_API_KEY → DASHSCOPE_API_KEY → QWEN_API_KEY (khớp đầu tiên được dùng) |
| Cờ thiết lập ban đầu | --auth-choice alibaba-model-studio-api-key |
| Cờ CLI trực tiếp | --alibaba-model-studio-api-key <key> |
| Mô hình mặc định | alibaba/wan2.6-t2v |
| URL cơ sở mặc định | https://dashscope-intl.aliyuncs.com |
Bắt đầu
Set an API key
Dùng quy trình thiết lập ban đầu để lưu khóa cho nhà cung cấp alibaba:
openclaw onboard --auth-choice alibaba-model-studio-api-key
Hoặc truyền khóa trực tiếp trong lúc cài đặt/thiết lập ban đầu:
openclaw onboard --alibaba-model-studio-api-key <your-key>
Hoặc xuất bất kỳ biến môi trường nào được chấp nhận trước khi khởi động Gateway:
export MODELSTUDIO_API_KEY=sk-...
# or DASHSCOPE_API_KEY=...
# or QWEN_API_KEY=...
Set a default video model
{
agents: {
defaults: {
videoGenerationModel: {
primary: "alibaba/wan2.6-t2v",
},
},
},
}
Verify the provider is configured
openclaw models list --provider alibaba
Danh sách này phải bao gồm cả năm mô hình Wan đi kèm. Nếu MODELSTUDIO_API_KEY chưa được phân giải, openclaw models status --json sẽ báo thông tin xác thực còn thiếu trong auth.unusableProfiles.
Các mô hình Wan tích hợp sẵn
| Tham chiếu mô hình | Chế độ |
|---|---|
alibaba/wan2.6-t2v |
Văn bản thành video (mặc định) |
alibaba/wan2.6-i2v |
Hình ảnh thành video |
alibaba/wan2.6-r2v |
Tham chiếu thành video |
alibaba/wan2.6-r2v-flash |
Tham chiếu thành video (nhanh) |
alibaba/wan2.7-r2v |
Tham chiếu thành video |
Khả năng và giới hạn
Nhà cung cấp đi kèm phản ánh các giới hạn của API video Wan của DashScope. Cả ba chế độ dùng chung giới hạn số video mỗi yêu cầu và giới hạn thời lượng; chỉ hình dạng đầu vào là khác nhau.
| Chế độ | Số video đầu ra tối đa | Số ảnh đầu vào tối đa | Số video đầu vào tối đa | Thời lượng tối đa | Điều khiển được hỗ trợ |
|---|---|---|---|---|---|
| Văn bản thành video | 1 | không áp dụng | không áp dụng | 10 giây | size, aspectRatio, resolution, audio, watermark |
| Hình ảnh thành video | 1 | 1 | không áp dụng | 10 giây | size, aspectRatio, resolution, audio, watermark |
| Tham chiếu thành video | 1 | không áp dụng | 4 | 10 giây | size, aspectRatio, resolution, audio, watermark |
Khi một yêu cầu bỏ qua durationSeconds, nhà cung cấp gửi giá trị mặc định được DashScope chấp nhận là 5 giây. Đặt rõ durationSeconds trên công cụ tạo video để kéo dài tối đa đến 10 giây.
Cấu hình nâng cao
Override the DashScope base URL
Nhà cung cấp mặc định dùng điểm cuối DashScope quốc tế. Để nhắm đến điểm cuối khu vực Trung Quốc, hãy đặt:
{
models: {
providers: {
alibaba: {
baseUrl: "https://dashscope.aliyuncs.com",
},
},
},
}
Nhà cung cấp loại bỏ dấu gạch chéo ở cuối trước khi tạo URL tác vụ AIGC.
Auth env priority
OpenClaw phân giải API key Alibaba từ các biến môi trường theo thứ tự này, lấy giá trị khác rỗng đầu tiên:
MODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_API_KEY
Các mục auth.profiles đã cấu hình (đặt qua openclaw models auth login) ghi đè phân giải biến môi trường. Xem hồ sơ xác thực trong FAQ về mô hình để biết cơ chế xoay vòng hồ sơ, thời gian chờ và ghi đè.
Relationship to the Qwen plugin
Cả hai Plugin đi kèm đều giao tiếp với DashScope và chấp nhận các API key chồng lắp. Dùng:
- ID
alibaba/wan*.*để điều khiển nhà cung cấp video Wan chuyên dụng được ghi lại trên trang này. - ID
qwen/*cho trò chuyện, embedding và hiểu phương tiện của Qwen (xem Qwen).
Đặt MODELSTUDIO_API_KEY một lần sẽ xác thực cả hai Plugin vì danh sách biến môi trường xác thực cố ý chồng lắp; bạn không cần thiết lập từng Plugin riêng.
Liên quan
Tham số công cụ video dùng chung và lựa chọn nhà cung cấp.
Thiết lập trò chuyện, embedding và hiểu phương tiện của Qwen trên cùng xác thực DashScope.
Mặc định của tác nhân và cấu hình mô hình.
Hồ sơ xác thực, chuyển đổi mô hình và xử lý lỗi "không có hồ sơ".