qwen を持つ公式外部 OpenClaw プロバイダー Plugin です。Qwen Cloud / Alibaba DashScope Standard および Coding Plan エンドポイントを対象とし、互換エイリアスとしてレガシーの modelstudio id を引き続き動作させ、Qwen Portal トークンフローを別のプロバイダー qwen-oauth として公開します。
| プロパティ | 値 |
|---|---|
| プロバイダー | qwen |
| Portal プロバイダー | qwen-oauth |
| 推奨 env var | QWEN_API_KEY |
| 互換で受け付けるもの | MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY |
| API スタイル | OpenAI 互換 |
Plugin をインストール
qwen は公式外部 Plugin として提供され、core にはバンドルされていません。インストールして Gateway を再起動します。
はじめに
プラン種別を選び、セットアップ手順に従ってください。- Coding Plan(サブスクリプション)
- Standard(従量課金)
- Qwen OAuth / Portal
最適な用途: Qwen Coding Plan 経由のサブスクリプションベースのアクセス。
API キーを取得する
home.qwencloud.com/api-keys で API キーを作成またはコピーします。
レガシーの
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-cn | coding.dashscope.aliyuncs.com/v1 |
| Coding Plan(サブスクリプション) | グローバル | qwen-api-key | coding-intl.dashscope.aliyuncs.com/v1 |
| Qwen Portal | グローバル | qwen-oauth | portal.qwen.ai/v1 |
| Standard(従量課金) | 中国 | qwen-standard-api-key-cn | dashscope.aliyuncs.com/compatible-mode/v1 |
| Standard(従量課金) | グローバル | qwen-standard-api-key | dashscope-intl.aliyuncs.com/compatible-mode/v1 |
qwen-* ファミリーを使用します。modelstudio-* は互換専用として残ります。設定内のカスタム baseUrl で上書きできます。
組み込みカタログ
OpenClaw はこの Qwen 静的カタログを提供します。このカタログはエンドポイントを認識します。Coding Plan 設定では、Standard エンドポイントでのみ動作するモデルは省略されます。| Model ref | 入力 | コンテキスト | 注記 |
|---|---|---|---|
qwen/qwen3.5-plus | テキスト、画像 | 1,000,000 | デフォルトモデル |
qwen/qwen3.6-plus | テキスト、画像 | 1,000,000 | Standard エンドポイントのみ |
qwen/qwen3-max-2026-01-23 | テキスト | 262,144 | Qwen 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,752 | GLM |
qwen/glm-4.7 | テキスト | 202,752 | GLM |
qwen/kimi-k2.5 | テキスト、画像 | 262,144 | Alibaba 経由の Moonshot AI |
qwen-oauth/qwen3.5-plus | テキスト、画像 | 1,000,000 | Qwen 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-i2v、wan2.6-r2v、wan2.6-r2v-flash、wan2.7-r2vによる Wan 動画生成
size、aspectRatio、resolution、audio、watermark をサポートします。参照画像/動画入力にはリモート http(s) URL が必要です。DashScope 動画エンドポイントはこれらの参照用にアップロードされたローカルバッファを受け付けないため、ローカルファイルパスは事前に拒否されます。
共有ツールパラメーター、プロバイダー選択、フェイルオーバー動作については、動画生成 を参照してください。
高度な設定
Qwen 3.6 Plus の利用可否
Qwen 3.6 Plus の利用可否
qwen3.6-plus は Standard(従量課金)エンドポイントで利用できます。- 中国:
dashscope.aliyuncs.com/compatible-mode/v1 - グローバル:
dashscope-intl.aliyuncs.com/compatible-mode/v1
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
models.providers.qwen.baseUrl でも、動画生成は対応するリージョンの DashScope 動画エンドポイントにルーティングされます。ストリーミング usage 互換性
ストリーミング usage 互換性
ネイティブ Qwen エンドポイントは共有
openai-completions transport 上でストリーミング usage 互換性を提示するため、同じネイティブホストを対象とする DashScope 互換のカスタムプロバイダー id は、組み込みの qwen プロバイダー id を特に必要とせずに同じ動作を継承します。これは Coding Plan と Standard の両方のエンドポイントに適用されます。https://coding.dashscope.aliyuncs.com/v1https://coding-intl.dashscope.aliyuncs.com/v1https://dashscope.aliyuncs.com/compatible-mode/v1https://dashscope-intl.aliyuncs.com/compatible-mode/v1
Capability 計画
Capability 計画
qwen Plugin は、コーディング/テキストモデルだけでなく、Qwen Cloud 全体のベンダーホームとして位置付けられています。- テキスト/チャットモデル: プラグインを通じて利用可能
- ツール呼び出し、構造化出力、思考: OpenAI 互換トランスポートから継承
- 画像生成: プロバイダープラグイン層で予定
- 画像/動画理解: Standard エンドポイントのプラグインを通じて利用可能
- 音声/オーディオ: プロバイダープラグイン層で予定
- メモリエンベディング/再ランキング: エンベディングアダプターサーフェスを通じて予定
- 動画生成: 共有の動画生成機能を通じてプラグインから利用可能
環境とデーモンのセットアップ
環境とデーモンのセットアップ
Gateway がデーモン(launchd/systemd)として実行される場合は、
QWEN_API_KEY が
そのプロセスで利用可能であることを確認してください(たとえば、~/.openclaw/.env 内、または
env.shellEnv 経由)。関連
モデル選択
プロバイダー、モデル参照、フェイルオーバー動作の選択。
動画生成
共有動画ツールのパラメーターとプロバイダー選択。
Alibaba Model Studio
同じ DashScope プラットフォーム上のバンドル済み Wan 動画生成プロバイダー。
トラブルシューティング
一般的なトラブルシューティングと FAQ。