阿里雲百煉模型服務平台

內建的 alibaba 外掛為 Alibaba Model Studio（DashScope 的國際名稱）上的 Wan 模型註冊影片生成供應商。此供應商預設啟用，只需要 API 金鑰。

屬性	值
供應商 ID	alibaba
外掛	內建，enabledByDefault: true
驗證環境變數	MODELSTUDIO_API_KEY → DASHSCOPE_API_KEY → QWEN_API_KEY（採用第一個相符項目）
初始設定旗標	--auth-choice alibaba-model-studio-api-key
直接命令列介面旗標	--alibaba-model-studio-api-key <key>
預設模型	alibaba/wan2.6-t2v
預設基礎 URL	https://dashscope-intl.aliyuncs.com

​

開始使用

1. 設定 API 金鑰

   透過初始設定將金鑰儲存至 alibaba 供應商：

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

   或直接傳入金鑰：

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

   或在啟動閘道前匯出任一可接受的環境變數：

   export MODELSTUDIO_API_KEY=sk-...
   # 或 DASHSCOPE_API_KEY=...
   # 或 QWEN_API_KEY=...
   
2. 設定預設影片模型

   {
     agents: {
       defaults: {
         videoGenerationModel: {
           primary: "alibaba/wan2.6-t2v",
         },
       },
     },
   }
   
3. 確認供應商已設定

   openclaw models list --provider alibaba
   

   清單包含全部五個內建的 Wan 模型。如果無法解析 MODELSTUDIO_API_KEY，openclaw models status --json 會在 auth.unusableProfiles 下回報缺少的認證資訊。

Alibaba 外掛和 Qwen 外掛都向 DashScope 進行驗證，並接受部分重疊的環境變數。專用的 Wan 影片介面請使用 alibaba/... 模型 ID；Qwen 聊天、嵌入或媒體理解則使用 qwen/... ID。

​

內建 Wan 模型

模型參照	模式
alibaba/wan2.6-t2v	文字轉影片（預設）
alibaba/wan2.6-i2v	圖片轉影片
alibaba/wan2.6-r2v	參照轉影片
alibaba/wan2.6-r2v-flash	參照轉影片（快速）
alibaba/wan2.7-r2v	參照轉影片

​

功能與限制

這三種模式的每次請求影片數量與時間長度上限皆相同，只有輸入格式不同。

模式	最大輸出影片數	最大輸入圖片數	最大輸入影片數	最長時間	支援的控制項
文字轉影片	1	不適用	不適用	10 秒	size、aspectRatio、resolution、audio、watermark
圖片轉影片	1	1	不適用	10 秒	size、aspectRatio、resolution、audio、watermark
參照轉影片	1	不適用	4	10 秒	size、aspectRatio、resolution、audio、watermark

省略 durationSeconds 的請求會採用 DashScope 接受的預設值 5 秒。在影片生成工具上明確設定 durationSeconds，可將時間延長至 10 秒。

參照圖片和影片輸入必須是遠端 http(s) URL；DashScope 的參照模式會拒絕本機檔案路徑。請先上傳至物件儲存空間，或使用已能產生公開 URL 的媒體工具流程。

​

進階設定

覆寫 DashScope 基礎 URL

供應商預設使用 DashScope 國際端點。若要指定中國地區端點：

{
  models: {
    providers: {
      alibaba: {
        baseUrl: "https://dashscope.aliyuncs.com",
      },
    },
  },
}

供應商會先移除結尾斜線，再建構 AIGC 工作 URL。

驗證環境變數優先順序

OpenClaw 會依下列順序從環境變數解析 Alibaba API 金鑰，並採用第一個非空值：

1. MODELSTUDIO_API_KEY
2. DASHSCOPE_API_KEY
3. QWEN_API_KEY

已設定的 auth.profiles 項目（透過 openclaw models auth login 設定）會覆寫環境變數解析。關於設定檔輪替、冷卻和覆寫機制，請參閱模型常見問題中的驗證設定檔。

與 Qwen 外掛的關係

這兩個內建外掛都會與 DashScope 通訊，並接受部分重疊的 API 金鑰。請使用：

• alibaba/wan*.* ID：用於本頁所述的專用 Wan 影片供應商。
• qwen/* ID：用於 Qwen 聊天、嵌入和媒體理解（請參閱 Qwen）。

由於驗證環境變數清單刻意重疊，只要設定一次 MODELSTUDIO_API_KEY 即可驗證這兩個外掛；不需要分別對每個外掛執行初始設定。

​

相關內容

影片生成

共用影片工具參數和供應商選擇。

Qwen

使用相同 DashScope 驗證的 Qwen 聊天、嵌入和媒體理解設定。

設定參考

代理程式預設值和模型設定。

模型常見問題

驗證設定檔、切換模型，以及解決「無設定檔」錯誤。