メインコンテンツへスキップ
Qwen Cloud は、正規 id qwen を持つ公式外部 OpenClaw プロバイダー Plugin です。Qwen Cloud / Alibaba DashScope Standard および Coding Plan エンドポイントを対象とし、互換エイリアスとしてレガシーの modelstudio id を引き続き動作させ、Qwen Portal トークンフローを別のプロバイダー qwen-oauth として公開します。
プロパティ
プロバイダーqwen
Portal プロバイダーqwen-oauth
推奨 env varQWEN_API_KEY
互換で受け付けるものMODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
API スタイルOpenAI 互換
qwen3.6-plus には Standard(従量課金) エンドポイントを使用してください。Coding Plan エンドポイントでは利用できません。

Plugin をインストール

qwen は公式外部 Plugin として提供され、core にはバンドルされていません。インストールして Gateway を再起動します。
openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

はじめに

プラン種別を選び、セットアップ手順に従ってください。
最適な用途: Qwen Coding Plan 経由のサブスクリプションベースのアクセス。
1

API キーを取得する

home.qwencloud.com/api-keys で API キーを作成またはコピーします。
2

オンボーディングを実行する

グローバル エンドポイントの場合:
openclaw onboard --auth-choice qwen-api-key
中国 エンドポイントの場合:
openclaw onboard --auth-choice qwen-api-key-cn
3

デフォルトモデルを設定する

{
  agents: {
    defaults: {
      model: { primary: "qwen/qwen3.5-plus" },
    },
  },
}
4

モデルが利用可能か確認する

openclaw models list --provider qwen
レガシーの modelstudio-* auth-choice id と modelstudio/... model ref は、互換エイリアスとして引き続き動作しますが、新しいセットアップフローでは正規の qwen-* auth-choice id と qwen/... model ref を優先してください。別の api 値を持つ厳密なカスタム models.providers.modelstudio エントリを定義した場合、そのカスタムプロバイダーが Qwen 互換エイリアスではなく modelstudio/... ref を所有します。

プラン種別とエンドポイント

プランリージョン認証選択エンドポイント
Coding Plan(サブスクリプション)中国qwen-api-key-cncoding.dashscope.aliyuncs.com/v1
Coding Plan(サブスクリプション)グローバルqwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Qwen Portalグローバルqwen-oauthportal.qwen.ai/v1
Standard(従量課金)中国qwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
Standard(従量課金)グローバルqwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
プロバイダーは認証選択に基づいてエンドポイントを自動選択します。正規の選択は qwen-* ファミリーを使用します。modelstudio-* は互換専用として残ります。設定内のカスタム baseUrl で上書きできます。
キーの管理: home.qwencloud.com/api-keys | ドキュメント: docs.qwencloud.com

組み込みカタログ

OpenClaw はこの Qwen 静的カタログを提供します。このカタログはエンドポイントを認識します。Coding Plan 設定では、Standard エンドポイントでのみ動作するモデルは省略されます。
Model ref入力コンテキスト注記
qwen/qwen3.5-plusテキスト、画像1,000,000デフォルトモデル
qwen/qwen3.6-plusテキスト、画像1,000,000Standard エンドポイントのみ
qwen/qwen3-max-2026-01-23テキスト262,144Qwen Max ライン
qwen/qwen3-coder-nextテキスト262,144コーディング
qwen/qwen3-coder-plusテキスト1,000,000コーディング
qwen/MiniMax-M2.5テキスト1,000,000推論有効
qwen/glm-5テキスト202,752GLM
qwen/glm-4.7テキスト202,752GLM
qwen/kimi-k2.5テキスト、画像262,144Alibaba 経由の Moonshot AI
qwen-oauth/qwen3.5-plusテキスト、画像1,000,000Qwen Portal デフォルト
モデルが静的カタログに存在する場合でも、利用可否はエンドポイントと課金プランによって変わることがあります。

thinking 制御

qwen/MiniMax-M2.5 は組み込みカタログで唯一の推論有効モデルです。qwen ファミリーの推論モデルでは、プロバイダーは OpenClaw の thinking レベルを DashScope のトップレベル enable_thinking リクエストフラグにマップします。thinking 無効時は enable_thinking: false を送信し、それ以外のレベルでは enable_thinking: true を送信します。カスタムモデルは、モデルエントリに compat.thinkingFormat: "qwen-chat-template" を設定することで、代替の chat-template thinking ペイロードを選択できます。

マルチモーダルアドオン

qwen Plugin は、Coding Plan エンドポイントではなく Standard DashScope エンドポイントでのみマルチモーダル機能を公開します。
  • qwen-vl-max-latest による 画像と動画の理解
  • wan2.6-t2v(デフォルト)、wan2.6-i2vwan2.6-r2vwan2.6-r2v-flashwan2.7-r2v による Wan 動画生成
メディア理解は設定済みの Qwen 認証から自動解決されます。追加設定は不要です。メディア理解を動作させるには、Standard(従量課金)エンドポイントを使用していることを確認してください。 Qwen をデフォルトの動画プロバイダーにするには、次のように設定します。
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },
    },
  },
}
動画生成の制限: リクエストごとに出力動画は 1 件、入力画像は最大 1 件(画像から動画)、入力動画は最大 4 件(動画から動画)、最大 duration は 10 秒です。sizeaspectRatioresolutionaudiowatermark をサポートします。参照画像/動画入力にはリモート http(s) URL が必要です。DashScope 動画エンドポイントはこれらの参照用にアップロードされたローカルバッファを受け付けないため、ローカルファイルパスは事前に拒否されます。
共有ツールパラメーター、プロバイダー選択、フェイルオーバー動作については、動画生成 を参照してください。

高度な設定

qwen3.6-plus は Standard(従量課金)エンドポイントで利用できます。
  • 中国: dashscope.aliyuncs.com/compatible-mode/v1
  • グローバル: dashscope-intl.aliyuncs.com/compatible-mode/v1
Coding Plan エンドポイントが qwen3.6-plus に対して「unsupported model」エラーを返す場合は、Coding Plan エンドポイント/キーペアではなく Standard(従量課金)に切り替えてください。OpenClaw の Qwen 静的カタログは Coding Plan エンドポイントで qwen3.6-plus を提示しませんが、models.providers.qwen.models の下に明示的に設定された qwen/qwen3.6-plus エントリは Coding Plan ベース URL でも尊重されるため、Aliyun があなたのサブスクリプションで有効化した場合は、そのモデルを opt in できます。呼び出しが成功するかどうかは、引き続き upstream API が決定します。
OpenClaw は動画ジョブを送信する前に、設定済みの Qwen リージョンを対応する DashScope AIGC ホストにマップします。
  • グローバル/Intl: https://dashscope-intl.aliyuncs.com
  • 中国: https://dashscope.aliyuncs.com
Coding Plan または Standard の Qwen ホストを指す通常の models.providers.qwen.baseUrl でも、動画生成は対応するリージョンの DashScope 動画エンドポイントにルーティングされます。
ネイティブ Qwen エンドポイントは共有 openai-completions transport 上でストリーミング usage 互換性を提示するため、同じネイティブホストを対象とする DashScope 互換のカスタムプロバイダー id は、組み込みの qwen プロバイダー id を特に必要とせずに同じ動作を継承します。これは Coding Plan と Standard の両方のエンドポイントに適用されます。
  • https://coding.dashscope.aliyuncs.com/v1
  • https://coding-intl.dashscope.aliyuncs.com/v1
  • https://dashscope.aliyuncs.com/compatible-mode/v1
  • https://dashscope-intl.aliyuncs.com/compatible-mode/v1
qwen Plugin は、コーディング/テキストモデルだけでなく、Qwen Cloud 全体のベンダーホームとして位置付けられています。
  • テキスト/チャットモデル: プラグインを通じて利用可能
  • ツール呼び出し、構造化出力、思考: OpenAI 互換トランスポートから継承
  • 画像生成: プロバイダープラグイン層で予定
  • 画像/動画理解: Standard エンドポイントのプラグインを通じて利用可能
  • 音声/オーディオ: プロバイダープラグイン層で予定
  • メモリエンベディング/再ランキング: エンベディングアダプターサーフェスを通じて予定
  • 動画生成: 共有の動画生成機能を通じてプラグインから利用可能
Gateway がデーモン(launchd/systemd)として実行される場合は、QWEN_API_KEY が そのプロセスで利用可能であることを確認してください(たとえば、~/.openclaw/.env 内、または env.shellEnv 経由)。

関連

モデル選択

プロバイダー、モデル参照、フェイルオーバー動作の選択。

動画生成

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

Alibaba Model Studio

同じ DashScope プラットフォーム上のバンドル済み Wan 動画生成プロバイダー。

トラブルシューティング

一般的なトラブルシューティングと FAQ。