Providers
阿里巴巴模型工作室
隨附的 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 |
開始使用
設定 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=...設定預設影片模型
{ agents: { defaults: { videoGenerationModel: { primary: "alibaba/wan2.6-t2v", }, }, },}確認供應商已設定
openclaw models list --provider alibaba清單會包含全部五個隨附的 Wan 模型。如果無法解析 MODELSTUDIO_API_KEY,openclaw models status --json 會在 auth.unusableProfiles 下回報缺少的認證資訊。
內建 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 秒。若要延長至最多 10 秒,請在影片生成工具中明確設定 durationSeconds。
進階設定
覆寫 DashScope 基底 URL
此供應商預設使用 DashScope 的國際端點。若要指定中國地區端點:
{ models: { providers: { alibaba: { baseUrl: "https://dashscope.aliyuncs.com", }, }, },}供應商會先移除結尾斜線,再建構 AIGC 任務 URL。
驗證環境變數優先順序
OpenClaw 會依下列順序從環境變數解析 Alibaba API 金鑰,並採用第一個非空值:
MODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_API_KEY
已設定的 auth.profiles 項目(透過 openclaw models auth login 設定)會覆寫環境變數解析。關於設定檔輪替、冷卻期和覆寫機制,請參閱模型常見問題中的驗證設定檔。
與 Qwen 外掛的關係
這兩個隨附外掛都會與 DashScope 通訊,並接受部分相同的 API 金鑰。請使用:
alibaba/wan*.*ID:用於本頁記載的專用 Wan 影片供應商。qwen/*ID:用於 Qwen 聊天、嵌入和媒體理解(請參閱 Qwen)。
只要設定一次 MODELSTUDIO_API_KEY,即可驗證兩個外掛,因為驗證環境變數清單刻意有所重疊;不需要分別為每個外掛執行新手設定。
相關內容
Was this useful?