跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 隨附一個 alibaba Plugin，會為 Alibaba Model Studio（DashScope 的國際名稱）上的 Wan 模型註冊影片生成提供者。此 Plugin 預設啟用；你只需要設定 API 金鑰。
屬性值
提供者 idalibaba
Plugin隨附，enabledByDefault: true
Auth 環境變數MODELSTUDIO_API_KEY → DASHSCOPE_API_KEY → QWEN_API_KEY（第一個符合者優先）
Onboarding 旗標--auth-choice alibaba-model-studio-api-key
直接 CLI 旗標--alibaba-model-studio-api-key <key>
預設模型alibaba/wan2.6-t2v
預設基礎 URLhttps://dashscope-intl.aliyuncs.com

​
開始使用

1

設定 API 金鑰

使用 onboarding 將金鑰儲存到 alibaba 提供者：
openclaw onboard --auth-choice alibaba-model-studio-api-key
或在安裝/onboarding 期間直接傳入金鑰：
openclaw onboard --alibaba-model-studio-api-key <your-key>
或在啟動 Gateway 前匯出任一受支援的環境變數：
export MODELSTUDIO_API_KEY=sk-...
# or DASHSCOPE_API_KEY=...
# or 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 Plugin 和 Qwen Plugin 都會對 DashScope 進行驗證，並接受重疊的環境變數。使用 alibaba/... 模型 id 來驅動專用的 Wan 影片介面；當你需要 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參照轉影片

​
功能與限制

隨附的提供者會對應 DashScope 的 Wan 影片 API 上限。三種模式共用相同的每次請求影片數量與時長上限；只有輸入形狀不同。
模式最大輸出影片數最大輸入圖片數最大輸入影片數最長時長支援的控制項
文字轉影片1n/an/a10 ssize, aspectRatio, resolution, audio, watermark
圖片轉影片11n/a10 ssize, aspectRatio, resolution, audio, watermark
參照轉影片1n/a410 ssize, aspectRatio, resolution, audio, watermark
當請求省略 durationSeconds 時，提供者會傳送 DashScope 接受的預設值 5 秒。在影片生成工具上明確設定 durationSeconds，可延長到最多 10 s。
參照圖片與影片輸入必須是遠端 http(s) 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 設定）會覆寫環境變數解析。請參閱模型 FAQ 中的 Auth 設定檔，了解設定檔輪換、冷卻與覆寫機制。
兩個隨附 Plugin 都會與 DashScope 通訊，並接受重疊的 API 金鑰。請使用：
  • alibaba/wan*.* id 來驅動本頁所記錄的專用 Wan 影片提供者。
  • qwen/* id 用於 Qwen 聊天、嵌入與媒體理解（請參閱 Qwen）。
只要設定一次 MODELSTUDIO_API_KEY，就會驗證兩個 Plugin，因為 auth 環境變數清單刻意重疊；你不需要分別 onboarding 每個 Plugin。

​
相關

影片生成

共用影片工具參數與提供者選擇。

Qwen

在相同 DashScope auth 上設定 Qwen 聊天、嵌入與媒體理解。

設定參考

Agent 預設值與模型設定。

模型 FAQ

Auth 設定檔、切換模型，以及解決「no profile」錯誤。