Providers
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 相容 |
安裝外掛
qwen 以官方外部外掛形式提供,不隨核心綁定。請安裝此外掛並重新啟動閘道:
openclaw plugins install @openclaw/qwen-provideropenclaw gateway restart開始使用
選擇方案類型,並依照設定步驟操作。
Coding 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 qwenStandard(隨用隨付)
**最適合:**透過 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 qwenToken Plan(團隊版)
**最適合:**透過 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-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(團隊版) | 中國 | 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 覆寫。
內建目錄
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/v1https://coding-intl.dashscope.aliyuncs.com/v1https://dashscope.aliyuncs.com/compatible-mode/v1https://dashscope-intl.aliyuncs.com/compatible-mode/v1https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1https://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 提供)。