阿里雲 Model Studio

OpenClaw 附帶一個內建的 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`
直接 CLI 標誌	`--alibaba-model-studio-api-key <key>`
預設模型	`alibaba/wan2.6-t2v`
預設基礎 URL	`https://dashscope-intl.aliyuncs.com`

開始使用

設定 API 金鑰

使用上架功能將金鑰儲存到 alibaba 供應商：

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

或在安裝/上架期間直接傳遞金鑰：

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

或在啟動 Gateway 之前匯出任何接受的環境變數：

```bash
export MODELSTUDIO_API_KEY=sk-...
# or DASHSCOPE_API_KEY=...
# or QWEN_API_KEY=...

設定預設視訊模型

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

內建提供者反映了 DashScope 的 Wan 影片 API 限制。這三種模式共用相同的單次請求影片數量與持續時間上限；僅輸入形態不同。

模式	最大輸出影片數	最大輸入圖片數	最大輸入影片數	最長持續時間	支援的控制項
文生影片	1	n/a	n/a	10 秒	`size`、`aspectRatio`、`resolution`、`audio`、`watermark`
圖生影片	1	1	n/a	10 秒	`size`、`aspectRatio`、`resolution`、`audio`、`watermark`
參考生影片	1	n/a	4	10 秒	`size`、`aspectRatio`、`resolution`、`audio`、`watermark`

當請求省略 durationSeconds 時，提供者會發送 DashScope 接受的預設值 5 秒。若要延長至 10 秒，請在影片生成工具上明確設定 durationSeconds。

覆寫 DashScope 基礎 URL

提供者預設使用國際版 DashScope 端點。若要指定中國區端點，請設定：

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

提供者在建構 AIGC 任務 URL 前會移除結尾斜線。

Auth env priority

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

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

Relationship to the Qwen plugin

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

由於驗證環境變數清單刻意重疊，只需設定一次 MODELSTUDIO_API_KEY 即可驗證這兩個外掛；您無需分別為每個外掛進行設定。