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 秒。在影片生成工具上明確設定 durationSeconds,可將時間延長至 10 秒。
進階設定
覆寫 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?