OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Alibaba Model Studio

Plugin alibaba được đóng gói sẵn đăng ký một 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 khóa API.

Thuộc tính Giá trị
ID nhà cung cấp alibaba
Plugin đóng gói sẵn, enabledByDefault: true
Biến môi trường xác thực MODELSTUDIO_API_KEY → DASHSCOPE_API_KEY → QWEN_API_KEY (giá trị 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

  • Đặt khóa API

    Lưu khóa cho nhà cung cấp alibaba thông qua quy trình thiết lập ban đầu:

    bash
    openclaw onboard --auth-choice alibaba-model-studio-api-key

    Hoặc truyền khóa trực tiếp:

    bash
    openclaw onboard --alibaba-model-studio-api-key <your-key>

    Hoặc xuất một trong các biến môi trường được chấp nhận trước khi khởi động Gateway:

    bash
    export MODELSTUDIO_API_KEY=sk-...# hoặc DASHSCOPE_API_KEY=...# hoặc QWEN_API_KEY=...

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

    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "alibaba/wan2.6-t2v",      },    },  },}

  • Xác minh nhà cung cấp đã được cấu hình

    bash
    openclaw models list --provider alibaba

    Danh sách bao gồm cả năm mô hình Wan được đóng gói sẵn. Nếu không thể phân giải MODELSTUDIO_API_KEY, openclaw models status --json sẽ báo thông tin xác thực bị 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 Nội dung tham chiếu thành video
    alibaba/wan2.6-r2v-flash Nội dung tham chiếu thành video (nhanh)
    alibaba/wan2.7-r2v Nội dung tham chiếu thành video

    Khả năng và giới hạn

    Cả ba chế độ có cùng giới hạn về số lượng video và thời lượng cho mỗi yêu cầu; chỉ cấu trúc đầu vào khác nhau.

    Chế độ Số video đầu ra tối đa Số hình ảnh đầu vào tối đa Số video đầu vào tối đa Thời lượng tối đa Tùy chọn đ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
    Nội dung tham chiếu thành video 1 không áp dụng 4 10 giây size, aspectRatio, resolution, audio, watermark

    Yêu cầu không chỉ định durationSeconds sẽ sử dụng giá trị mặc định được DashScope chấp nhận là 5 giây. Hãy đặt durationSeconds rõ ràng trong công cụ tạo video để tăng thời lượng lên tối đa 10 giây.

    Cấu hình nâng cao

    Ghi đè URL cơ sở của DashScope

    Theo mặc định, nhà cung cấp sử dụng điểm cuối DashScope quốc tế. Để nhắm đến điểm cuối tại khu vực Trung Quốc:

    json5
    {  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.

    Mức ưu tiên của biến môi trường xác thực

    OpenClaw phân giải khóa API Alibaba từ các biến môi trường theo thứ tự sau và sử dụng giá trị không rỗng đầu tiên:

    1. MODELSTUDIO_API_KEY
    2. DASHSCOPE_API_KEY
    3. QWEN_API_KEY

    Các mục auth.profiles đã cấu hình (được đặt qua openclaw models auth login) sẽ ghi đè việc phân giải biến môi trường. Xem Hồ sơ xác thực trong phần câu hỏi thường gặp về mô hình để biết cơ chế luân phiên hồ sơ, thời gian chờ và ghi đè.

    Mối quan hệ với Plugin Qwen

    Cả hai Plugin được đóng gói sẵn đều giao tiếp với DashScope và chấp nhận các khóa API trùng nhau. Hãy dùng:

    • ID alibaba/wan*.* cho nhà cung cấp video Wan chuyên dụng được trình bày trên trang này.
    • ID qwen/* cho trò chuyện, embedding và hiểu nội dung đa phương tiện bằng Qwen (xem Qwen).

    Chỉ cần đặt MODELSTUDIO_API_KEY một lần để xác thực cả hai Plugin, vì danh sách biến môi trường xác thực được chủ ý thiết kế trùng nhau; không cần thiết lập ban đầu riêng cho từng Plugin.

    Nội dung liên quan

    Tạo video

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

    Thiết lập trò chuyện, embedding và hiểu nội dung đa phương tiện bằng Qwen với cùng cơ chế xác thực DashScope.
    Tham chiếu cấu hình

    Các giá trị mặc định của tác nhân và cấu hình mô hình.
    Câu hỏi thường gặp về 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ơ".
    Was this useful?
    On this page

    On this page