メインコンテンツへスキップ

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 Model Studio（DashScope の国際名）の Wan モデル向け動画生成プロバイダーを登録する、バンドル済みの alibaba Plugin が付属しています。この Plugin はデフォルトで有効です。API キーを設定するだけで使用できます。
プロパティ値
プロバイダーIDalibaba
Pluginバンドル済み、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
デフォルトのベース URLhttps://dashscope-intl.aliyuncs.com

​
はじめに

1

Set an API key

オンボーディングを使用して、alibaba プロバイダーにキーを保存します。
openclaw onboard --auth-choice alibaba-model-studio-api-key
または、インストール/オンボーディング時にキーを直接渡します。
openclaw onboard --alibaba-model-studio-api-key <your-key>
または、Gateway を起動する前に、受け付けられる環境変数のいずれかをエクスポートします。
export MODELSTUDIO_API_KEY=sk-...
# or DASHSCOPE_API_KEY=...
# or QWEN_API_KEY=...
2

Set a default video model

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

Verify the provider is configured

openclaw models list --provider alibaba
一覧には、バンドル済みの 5 つの Wan モデルすべてが含まれているはずです。MODELSTUDIO_API_KEY を解決できない場合、openclaw models status --json は不足している認証情報を auth.unusableProfiles の下に報告します。
Alibaba Plugin と Qwen Plugin はどちらも 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参照から動画

​
機能と制限

バンドル済みプロバイダーは、DashScope の Wan 動画 API の上限に合わせています。3 つのモードすべてで、リクエストあたりの動画数と時間の上限は同じです。異なるのは入力形式のみです。
モード最大出力動画数最大入力画像数最大入力動画数最大時間対応する制御項目
テキストから動画1n/an/a10 秒size, aspectRatio, resolution, audio, watermark
画像から動画11n/a10 秒size, aspectRatio, resolution, audio, watermark
参照から動画1n/a410 秒size, aspectRatio, resolution, audio, watermark
リクエストで durationSeconds を省略した場合、プロバイダーは DashScope が受け付けるデフォルトの 5 秒 を送信します。最大 10 秒まで延長するには、動画生成ツールで durationSeconds を明示的に設定します。
参照画像と動画の入力は、リモートの http(s) URL である必要があります。ローカルファイルパスは DashScope の参照モードでは受け付けられません。先にオブジェクトストレージへアップロードするか、すでに公開 URL を生成する media tool フローを使用してください。

​
高度な設定

プロバイダーはデフォルトで国際版 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 の認証プロファイルを参照してください。
バンドル済みの両 Plugin は DashScope と通信し、重複する API キーを受け付けます。次のように使い分けます。
  • このページで説明している専用の Wan 動画プロバイダーを使用するには、alibaba/wan*.* ID を使います。
  • Qwen のチャット、埋め込み、メディア理解には qwen/* ID を使います（Qwen を参照）。
認証環境変数の一覧は意図的に重複しているため、MODELSTUDIO_API_KEY を一度設定すれば両方の Plugin が認証されます。各 Plugin を個別にオンボーディングする必要はありません。

​
関連

Video generation

共有の動画ツールパラメーターとプロバイダー選択。

Qwen

同じ DashScope 認証を使用する Qwen のチャット、埋め込み、メディア理解のセットアップ。

Configuration reference

エージェントのデフォルトとモデル設定。

Models FAQ

認証プロファイル、モデル切り替え、「no profile」エラーの解決。