Providers

Qwen

Qwen Cloud は、正規 id qwen を持つ公式の外部 OpenClaw プロバイダー Plugin です。Qwen Cloud / Alibaba DashScope の Standard および Coding Plan エンドポイントを対象とし、Token Plan を qwen-token-plan として公開し、modelstudio を互換性エイリアスとして維持するほか、Alibaba が文書化している bailian-token-plan カスタムプロバイダー id を独立して所有します。

プロパティ
プロバイダー qwen
Token Plan プロバイダー qwen-token-plan
推奨環境変数 QWEN_API_KEY
Token Plan 環境変数 QWEN_TOKEN_PLAN_API_KEY
追加で受け付ける値(互換性) MODELSTUDIO_API_KEY, DASHSCOPE_API_KEY
API 形式 OpenAI 互換

Plugin のインストール

qwen は、コアに同梱されない公式の外部 Plugin として提供されます。インストールして Gateway を再起動します。

bash
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart

はじめに

プラン種別を選択し、セットアップ手順に従ってください。

Coding Plan(サブスクリプション)

最適な用途: Qwen Coding Plan を通じたサブスクリプションベースのアクセス。

  • API キーを取得する

    home.qwencloud.com/api-keys で API キーを作成するか、コピーします。

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

    グローバルエンドポイントの場合:

    bash
    openclaw onboard --auth-choice qwen-api-key

    中国エンドポイントの場合:

    bash
    openclaw onboard --auth-choice qwen-api-key-cn
  • デフォルトモデルを設定する

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • モデルが利用可能であることを確認する

    bash
    openclaw models list --provider qwen
  • Standard(従量課金)

    最適な用途: Coding Plan では利用できない qwen3.7-max および qwen3.6-flash を含む、Standard Model Studio エンドポイントを通じた従量課金アクセス。

  • API キーを取得する

    home.qwencloud.com/api-keys で API キーを作成するか、コピーします。

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

    グローバルエンドポイントの場合:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key

    中国エンドポイントの場合:

    bash
    openclaw onboard --auth-choice qwen-standard-api-key-cn
  • デフォルトモデルを設定する

    json5
    {  agents: {    defaults: {      model: { primary: "qwen/qwen3.5-plus" },    },  },}
  • モデルが利用可能であることを確認する

    bash
    openclaw models list --provider qwen
  • Token Plan(Team Edition)

    最適な用途: Alibaba Cloud Model Studio を通じた、Qwen およびサポート対象のサードパーティモデルへのクレジットベースのチームサブスクリプションアクセス。

  • 専用キーを取得する

    Token Plan シートを割り当て、専用の sk-sp-... キーを作成します。Token Plan、Coding Plan、従量課金のキーに互換性はありません。グローバル Token Plan の概要または中国 Token Plan の概要を参照してください。

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

    シンガポールのグローバル / 国際エンドポイントの場合:

    bash
    openclaw onboard --auth-choice qwen-token-plan

    北京の中国エンドポイントの場合:

    bash
    openclaw onboard --auth-choice qwen-token-plan-cn
  • プロバイダーを確認する

    bash
    openclaw models list --provider qwen-token-planopenclaw agent --model qwen-token-plan/qwen3.7-plus --message "Token Plan の準備完了と返信してください"
  • プラン種別とエンドポイント

    プラン リージョン 認証選択肢 エンドポイント
    Coding Plan(サブスクリプション) 中国 qwen-api-key-cn coding.dashscope.aliyuncs.com/v1
    Coding Plan(サブスクリプション) グローバル qwen-api-key coding-intl.dashscope.aliyuncs.com/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
    Token Plan(Team Edition) 中国 qwen-token-plan-cn token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    Token Plan(Team Edition) グローバル qwen-token-plan token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

    プロバイダーは、認証選択肢に基づいてエンドポイントを自動選択します。正規の 選択肢では qwen-* ファミリーを使用し、modelstudio-* は互換性専用として維持されます。 設定内のカスタム baseUrl で上書きできます。

    組み込みカタログ

    OpenClaw には、この Qwen 静的カタログが付属しています。カタログはエンドポイントを認識します。Coding Plan の設定では、Standard エンドポイントでのみ動作するモデルが除外されます。

    モデル参照 入力 コンテキスト 備考
    qwen/qwen3.5-plus テキスト、画像 1,000,000 デフォルトモデル
    qwen/qwen3.6-flash テキスト、画像 1,000,000 Standard エンドポイントのみ
    qwen/qwen3.6-plus テキスト、画像 1,000,000 Coding Plan + Standard
    qwen/qwen3.7-max テキスト 1,000,000 Standard エンドポイントのみ
    qwen/qwen3.7-plus テキスト、画像 1,000,000 Coding Plan + 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

    Token Plan カタログ

    Token Plan は、完全一致文字列の個別の許可リストを使用します。画像生成専用のプラン モデルは異なる API を使用するため、ここには含まれていません。

    モデル参照 入力 コンテキスト
    qwen-token-plan/qwen3.7-max テキスト 1,000,000
    qwen-token-plan/qwen3.7-plus テキスト、画像 1,000,000
    qwen-token-plan/qwen3.6-plus テキスト、画像 1,000,000
    qwen-token-plan/qwen3.6-flash テキスト、画像 1,000,000
    qwen-token-plan/deepseek-v4-pro テキスト 1,000,000
    qwen-token-plan/deepseek-v4-flash テキスト 1,000,000
    qwen-token-plan/deepseek-v3.2 テキスト 131,072
    qwen-token-plan/kimi-k2.7-code テキスト、画像 262,144
    qwen-token-plan/kimi-k2.6 テキスト、画像 262,144
    qwen-token-plan/kimi-k2.5 テキスト、画像 262,144
    qwen-token-plan/glm-5.2 テキスト 1,000,000
    qwen-token-plan/glm-5.1 テキスト 202,752
    qwen-token-plan/glm-5 テキスト 202,752
    qwen-token-plan/MiniMax-M2.5 テキスト 196,608

    思考制御

    qwen3.7-maxqwen3.7-plusqwen3.6-flashqwen3.6-plus は、 組み込みカタログで推論が有効です。qwen ファミリーの推論モデルでは、プロバイダーが OpenClaw の思考レベルを DashScope のトップレベル enable_thinking リクエストフラグにマッピングします。思考を無効にすると enable_thinking: false を送信し、 それ以外のレベルでは enable_thinking: true を送信します。カスタムモデルでは、モデルエントリに compat.thinkingFormat: "qwen-chat-template" を設定することで、別のチャットテンプレート思考ペイロードを 有効にできます。

    Token Plan モデルにも推論対応のマークが付いています。kimi-k2.7-codeMiniMax-M2.5 は思考専用であるため、セッションが /think off を要求しても OpenClaw は思考を有効なままにします。DeepSeek V4 は minimal から high を サービスの high effort にマッピングし、xhigh または maxmax にマッピングします。GLM 5.2 は minimal から max までの全範囲を受け付けます。GLM 5.1 と GLM 5 は xhigh までを受け付け、3 つすべてのデフォルトは high です。その他のハイブリッドモデルは、 要求されたオン / オフ状態に従います。

    マルチモーダルアドオン

    qwen Plugin は、Coding Plan エンドポイントではなく、Standard DashScope エンドポイントでのみマルチモーダル機能を提供します。

    • 画像および動画の理解qwen3.6-plus 経由)
    • Wan 動画生成wan2.6-t2v〔デフォルト〕、wan2.6-i2vwan2.6-r2vwan2.6-r2v-flashwan2.7-r2v 経由)

    メディア理解は、設定済みの Qwen 認証から自動的に解決されるため、追加の 設定は不要です。メディア理解を機能させるには、Standard(従量課金)エンドポイントを 使用していることを確認してください。

    Qwen をデフォルトの動画プロバイダーにするには:

    json5
    {  agents: {    defaults: {      videoGenerationModel: { primary: "qwen/wan2.6-t2v" },    },  },}

    動画生成の制限: リクエストあたり出力動画は1本、入力画像は最大1枚 (画像から動画)、入力動画は最大4本(動画から動画)、長さは最大10秒です。 sizeaspectRatioresolutionaudio、 およびwatermarkをサポートします。参照画像/動画の入力にはリモート http(s) URL が必要です。 DashScope の動画エンドポイントはこれらの参照用にアップロードされたローカルバッファを 受け付けないため、ローカルファイルパスは事前に拒否されます。

    高度な設定

    Qwen 3.6 と 3.7 の利用可否

    qwen3.7-plusqwen3.6-plusは、Coding Plan と Standard のエンドポイントで利用できます。qwen3.7-maxqwen3.6-flashは Standard でのみ利用できます。Standard(従量課金制)のエンドポイントは次のとおりです。

    • 中国: dashscope.aliyuncs.com/compatible-mode/v1
    • グローバル: dashscope-intl.aliyuncs.com/compatible-mode/v1

    OpenClaw は Coding Plan のカタログからqwen3.7-maxqwen3.6-flashを除外します。 Coding Plan のエンドポイントでいずれかに対して「unsupported model」エラーが返された場合は、 対応する Standard エンドポイントとキーに切り替えてください。

    動画生成のリージョンルーティング

    OpenClaw は動画ジョブを送信する前に、設定された Qwen リージョンを 対応する DashScope AIGC ホストにマッピングします。

    • グローバル/国際: https://dashscope-intl.aliyuncs.com
    • 中国: https://dashscope.aliyuncs.com

    Coding Plan または Standard の Qwen ホストのいずれかを指す通常の models.providers.qwen.baseUrlでも、動画生成は対応するリージョンの DashScope 動画エンドポイントにルーティングされます。

    ストリーミング使用量の互換性

    ネイティブ Qwen エンドポイントは、共有openai-completionsトランスポート上で ストリーミング使用量の互換性を通知します。そのため、同じネイティブホストを 対象とする DashScope 互換のカスタムプロバイダー ID は、組み込みの qwenプロバイダー ID を明示的に使用しなくても、同じ動作を継承します。 これは Coding Plan、Standard、Token Plan の各エンドポイントに適用されます。

    • 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
    • https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
    • https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    機能計画

    qwen Plugin は、コーディング/テキストモデルだけでなく、Qwen Cloud の 全機能を扱うベンダー側の基盤として位置づけられています。

    • テキスト/チャットモデル: Plugin を通じて利用可能
    • ツール呼び出し、構造化出力、思考: OpenAI 互換トランスポートから継承
    • 画像生成: プロバイダー Plugin レイヤーで対応予定
    • 画像/動画理解: Standard エンドポイント上の Plugin を通じて利用可能
    • 音声/オーディオ: プロバイダー Plugin レイヤーで対応予定
    • メモリの埋め込み/再ランキング: 埋め込みアダプターのサーフェスを通じて対応予定
    • 動画生成: 共有動画生成機能を介して Plugin から利用可能
    環境とデーモンのセットアップ

    Gateway をデーモン(launchd/systemd)として実行する場合は、QWEN_API_KEY またはQWEN_TOKEN_PLAN_API_KEYをそのプロセスから利用できることを確認してください (たとえば、~/.openclaw/.env内、またはenv.shellEnv経由)。

    関連項目

    Was this useful?
    On this page

    On this page