Qwen

Qwen Cloud 是官方的外部 OpenClaw 提供者外掛，標準 id 為 qwen。它適用於 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 相容

qwen3.7-plus 和 qwen3.6-plus 可搭配 Coding Plan 與 Standard 端點使用。若要使用 qwen3.7-max 或 qwen3.6-flash，請使用 **Standard（隨用隨付）**端點。

安裝外掛

qwen 以官方外部外掛形式提供，不隨核心綁定。請安裝此外掛並重新啟動閘道：

openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart

開始使用

選擇方案類型，並依照設定步驟操作。

Coding Plan（訂閱制）
Standard（隨用隨付）
Token Plan（團隊版）

**最適合：**透過 Qwen Coding Plan 取得訂閱制存取權。

取得 API 金鑰

從 home.qwencloud.com/api-keys 建立或複製 API 金鑰。

執行初始設定

若使用全球端點：

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

若使用中國端點：

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

設定預設模型

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

驗證模型是否可用

openclaw models list --provider qwen

舊版 modelstudio-* 認證選擇 id 與 modelstudio/... 模型參照仍可作為相容性別名使用，但新的設定流程應優先使用標準的 qwen-* 認證選擇 id 與 qwen/... 模型參照。如果你定義了完全相符的自訂 models.providers.modelstudio 項目，且其 api 值不同，該自訂提供者將擁有 modelstudio/... 參照，而非 Qwen 相容性別名。

**最適合：**透過 Standard Model Studio 端點取得隨用隨付存取權，包括 Coding Plan 不提供的 qwen3.7-max 與 qwen3.6-flash。

取得 API 金鑰

從 home.qwencloud.com/api-keys 建立或複製 API 金鑰。

執行初始設定

若使用全球端點：

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

若使用中國端點：

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

設定預設模型

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

驗證模型是否可用

openclaw models list --provider qwen

**最適合：**透過 Alibaba Cloud Model Studio，以點數制團隊訂閱方式存取 Qwen 與支援的第三方模型。

取得專用金鑰

指派一個 Token Plan 席次，並建立其專用的 sk-sp-... 金鑰。Token Plan、Coding Plan 與隨用隨付金鑰無法互換使用。請參閱全球 Token Plan 概覽或中國 Token Plan 概覽。

執行初始設定

若使用位於新加坡的全球／國際端點：

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

若使用位於北京的中國端點：

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

驗證提供者

openclaw models list --provider qwen-token-plan
openclaw agent --model qwen-token-plan/qwen3.7-plus --message "回覆：Token Plan 已就緒"

Alibaba 的 OpenClaw 指南使用 bailian-token-plan 作為手動自訂提供者。此前掛會將該 id 註冊為相容性擁有者，但新的設定應使用 qwen-token-plan。完全相符的自訂 models.providers.bailian-token-plan 項目會保有其已設定傳輸方式與目錄的擁有權；它絕不會合併至標準 OpenAI 目錄。

Token Plan 僅可用於互動式 OpenClaw 工作階段。請勿將它用於排程工作、無人值守指令碼或應用程式後端。Alibaba 表示，非互動式使用可能會導致訂閱遭停用，或其 API 金鑰遭撤銷。

方案類型與端點

方案	區域	認證選擇	端點
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（團隊版）	中國	`qwen-token-plan-cn`	`token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`
Token Plan（團隊版）	全球	`qwen-token-plan`	`token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`

提供者會根據你的認證選擇自動選取端點。標準選項使用 qwen-* 系列；modelstudio-* 僅保留供相容性使用。可在設定中透過自訂 baseUrl 覆寫。

管理金鑰：home.qwencloud.com/api-keys | 文件：docs.qwencloud.com

內建目錄

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-max、qwen3.7-plus、qwen3.6-flash 與 qwen3.6-plus 在內建目錄中已啟用推理。對於 qwen 系列的推理模型，提供者會將 OpenClaw 的思考層級對應至 DashScope 頂層的 enable_thinking 請求旗標：停用思考時傳送 enable_thinking: false，任何其他層級則傳送 enable_thinking: true。自訂模型可在模型項目中設定 compat.thinkingFormat: "qwen-chat-template"，以選用替代的聊天範本思考承載內容。 Token Plan 模型也標示為具備推理能力。kimi-k2.7-code 與 MiniMax-M2.5 僅支援思考，因此即使工作階段要求 /think off，OpenClaw 仍會保持啟用思考。DeepSeek V4 會將 minimal 到 high 對應至服務的 high 強度，並將 xhigh 或 max 對應至 max。GLM 5.2 接受從 minimal 到 max 的完整範圍；GLM 5.1 與 GLM 5 接受最高至 xhigh，且三者皆預設為 high。其他混合模型會遵循要求的開啟／關閉狀態。

多模態附加功能

qwen 外掛僅在 Standard DashScope 端點上提供多模態功能，不支援 Coding Plan 端點：

影像與影片理解，透過 qwen3.6-plus
Wan 影片生成，透過 wan2.6-t2v（預設）、wan2.6-i2v、wan2.6-r2v、wan2.6-r2v-flash、wan2.7-r2v

系統會根據已設定的 Qwen 認證自動解析媒體理解功能；不需要額外設定。若要使用媒體理解功能，請確認使用的是 Standard（隨用隨付）端點。若要將 Qwen 設為預設影片提供者：

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

影片生成限制：每個請求可輸出 1 部影片、最多可輸入 1 張圖片（圖片轉影片）、最多可輸入 4 部影片（影片轉影片），最長 10 秒。支援 size、aspectRatio、resolution、audio 和 watermark。參考圖片／影片輸入必須使用遠端 http(s) URL；系統會預先拒絕本機檔案路徑，因為 DashScope 影片端點不接受為這些參考資料上傳的本機緩衝區。

如需共用工具參數、供應商選擇和容錯移轉行為，請參閱影片生成。

進階設定

Qwen 3.6 和 3.7 的可用性

qwen3.7-plus 和 qwen3.6-plus 可用於 Coding Plan 和 Standard 端點。qwen3.7-max 和 qwen3.6-flash 僅適用於 Standard。Standard（隨用隨付）端點如下：

中國：dashscope.aliyuncs.com/compatible-mode/v1
全球：dashscope-intl.aliyuncs.com/compatible-mode/v1

OpenClaw 會從 Coding Plan 目錄中省略 qwen3.7-max 和 qwen3.6-flash。如果 Coding Plan 端點對其中任一模型傳回「不支援的模型」錯誤，請切換至相符的 Standard 端點和金鑰。

影片生成區域路由

OpenClaw 會先將設定的 Qwen 區域對應至相符的 DashScope AIGC 主機，再提交影片工作：

全球／國際：https://dashscope-intl.aliyuncs.com
中國：https://dashscope.aliyuncs.com

一般的 models.providers.qwen.baseUrl 無論指向 Coding Plan 或 Standard Qwen 主機，仍會將影片生成路由至相符的區域 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 外掛的定位是完整 Qwen Cloud 介面的供應商歸屬位置，而不僅限於程式設計／文字模型。

**文字／聊天模型：**可透過此外掛使用
**工具呼叫、結構化輸出、思考：**繼承自 OpenAI 相容傳輸
**圖片生成：**規劃於供應商外掛層提供
**圖片／影片理解：**可透過 Standard 端點上的外掛使用
**語音／音訊：**規劃於供應商外掛層提供
**記憶嵌入／重新排序：**規劃透過嵌入轉接器介面提供
**影片生成：**可透過此外掛及共用影片生成功能使用

環境與常駐程式設定

如果閘道以常駐程式（launchd/systemd）執行，請確保該程序可取得 QWEN_API_KEY 或 QWEN_TOKEN_PLAN_API_KEY（例如放在 ~/.openclaw/.env 中，或透過 env.shellEnv 提供）。

模型選擇

選擇供應商、模型參照和容錯移轉行為。

影片生成

共用影片工具參數和供應商選擇。

Alibaba Model Studio

位於相同 DashScope 平台上的內建 Wan 影片生成供應商。

疑難排解

一般疑難排解和常見問題。

Overview

Concepts and configuration

Providers

安裝外掛

開始使用

方案類型與端點

內建目錄

Token Plan 目錄

思考控制

多模態附加功能

進階設定

相關資源

模型選擇

影片生成

Alibaba Model Studio

疑難排解

​安裝外掛

​開始使用

​方案類型與端點

​內建目錄

​Token Plan 目錄

​思考控制

​多模態附加功能

​進階設定

​相關資源

模型選擇

影片生成

Alibaba Model Studio

疑難排解

安裝外掛

開始使用

方案類型與端點

內建目錄

Token Plan 目錄

思考控制

多模態附加功能

進階設定

相關資源