Providers
Qwen
Qwen Cloud 是官方的外部 OpenClaw 供應商外掛,標準識別碼為 qwen。它適用於 Qwen Cloud/Alibaba DashScope 標準版與 Coding Plan 端點,將 Token Plan 公開為 qwen-token-plan,保留 modelstudio 作為相容性別名,獨立擁有 Alibaba 文件所述的 bailian-token-plan 自訂供應商識別碼,並將 Qwen Portal 權杖流程公開為 qwen-oauth。
| 屬性 | 值 |
|---|---|
| 供應商 | qwen |
| Token Plan 供應商 | qwen-token-plan |
| Portal 供應商 | qwen-oauth |
| 慣用環境變數 | 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 qwen標準版(隨用隨付)
**最適合:**透過標準版 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 "Reply with: token plan ready"Qwen OAuth/Portal
**最適合:**針對 https://portal.qwen.ai/v1 使用 Qwen Portal 權杖。
如需專用供應商頁面與遷移注意事項,請參閱 Qwen OAuth/Portal。
提供 Portal 權杖
openclaw onboard --auth-choice qwen-oauth設定預設模型
{ agents: { defaults: { model: { primary: "qwen-oauth/qwen3.5-plus" }, }, },}確認模型可用
openclaw models list --provider qwen-oauth方案類型與端點
| 方案 | 區域 | 驗證選項 | 端點 |
|---|---|---|---|
| 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 |
| 標準版(隨用隨付) | 中國 | qwen-standard-api-key-cn |
dashscope.aliyuncs.com/compatible-mode/v1 |
| 標準版(隨用隨付) | 全球 | 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 設定會略過僅能在標準版端點運作的模型。
| 模型參照 | 輸入 | 上下文 | 備註 |
|---|---|---|---|
qwen/qwen3.5-plus |
文字、圖片 | 1,000,000 | 預設模型 |
qwen/qwen3.6-flash |
文字、圖片 | 1,000,000 | 僅限標準版端點 |
qwen/qwen3.6-plus |
文字、圖片 | 1,000,000 | Coding Plan+標準版 |
qwen/qwen3.7-max |
文字 | 1,000,000 | 僅限標準版端點 |
qwen/qwen3.7-plus |
文字、圖片 | 1,000,000 | Coding Plan+標準版 |
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 預設模型 |
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 外掛僅在 DashScope 的 Standard 端點上提供多模態功能,不支援 Coding Plan 端點:
- 透過
qwen-vl-max-latest進行圖片與影片理解 - 透過
wan2.6-t2v(預設)、wan2.6-i2v、wan2.6-r2v、wan2.6-r2v-flash、wan2.7-r2v進行 Wan 影片生成
媒體理解功能會根據已設定的 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 提供)。