--- read_when: - 你想要搭配 OpenClaw 使用 Qwen - 您已訂閱 Alibaba Cloud Token Plan - 您先前使用的是 Qwen OAuth summary: 透過 OpenClaw 外掛使用 Qwen Cloud title: Qwen x-i18n: generated_at: "2026-07-11T21:44:18Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 18030a70c024cd5c0713262874f5353bac50576e850f68a61bef4fa73ccf9b9c source_path: providers/qwen.md workflow: 16 --- Qwen Cloud 是官方的外部 OpenClaw 供應商外掛，標準識別碼為 `qwen`。它適用於 Qwen Cloud／Alibaba DashScope 標準版與 Coding Plan 端點，將 Token Plan 公開為 `qwen-token-plan`，保留 `modelstudio` 作為相容性別名，獨立擁有 Alibaba 文件所述的 `bailian-token-plan` 自訂供應商識別碼，並將 Qwen Portal 權杖流程公開為 [`qwen-oauth`](/zh-TW/providers/qwen-oauth)。 | 屬性 | 值 | | ---------------------- | ------------------------------------------ | | 供應商 | `qwen` | | Token Plan 供應商 | `qwen-token-plan` | | Portal 供應商 | [`qwen-oauth`](/zh-TW/providers/qwen-oauth) | | 慣用環境變數 | `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 與標準版端點使用。 若要使用 `qwen3.7-max` 或 `qwen3.6-flash`，請使用**標準版（隨用隨付）**端點。 ## 安裝外掛 `qwen` 以官方外部外掛形式提供，不與核心綁定。請安裝此外掛並重新啟動閘道： ```bash openclaw plugins install @openclaw/qwen-provider openclaw gateway restart ``` ## 開始使用 選擇方案類型，然後依照設定步驟操作。 **最適合：**透過 Qwen Coding Plan 使用訂閱制存取。 從 [home.qwencloud.com/api-keys](https://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 ``` 舊版 `modelstudio-*` 驗證選項識別碼與 `modelstudio/...` 模型參照仍可作為相容性別名使用，但新的設定流程應優先使用標準的 `qwen-*` 驗證選項識別碼與 `qwen/...` 模型參照。如果你定義了完全相符、且具有其他 `api` 值的自訂 `models.providers.modelstudio` 項目，該自訂供應商將擁有 `modelstudio/...` 參照，而非由 Qwen 相容性別名擁有。 **最適合：**透過標準版 Model Studio 端點使用隨用隨付存取，包括 Coding Plan 不提供的 `qwen3.7-max` 與 `qwen3.6-flash`。 從 [home.qwencloud.com/api-keys](https://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 ``` 舊版 `modelstudio-*` 驗證選項識別碼與 `modelstudio/...` 模型參照仍可作為相容性別名使用，但新的設定流程應優先使用標準的 `qwen-*` 驗證選項識別碼與 `qwen/...` 模型參照。如果你定義了完全相符、且具有其他 `api` 值的自訂 `models.providers.modelstudio` 項目，該自訂供應商將擁有 `modelstudio/...` 參照，而非由 Qwen 相容性別名擁有。 **最適合：**透過 Alibaba Cloud Model Studio，以點數制團隊訂閱方式存取 Qwen 與支援的第三方模型。 指派一個 Token Plan 席位，並建立其專用的 `sk-sp-...` 金鑰。Token Plan、Coding Plan 與隨用隨付金鑰無法互換。請參閱[全球 Token Plan 概覽](https://www.alibabacloud.com/help/en/model-studio/token-plan-overview)或[中國 Token Plan 概覽](https://help.aliyun.com/zh/model-studio/token-plan-overview)。 若使用位於新加坡的**全球／國際**端點： ```bash openclaw onboard --auth-choice qwen-token-plan ``` 若使用位於北京的**中國**端點： ```bash openclaw onboard --auth-choice qwen-token-plan-cn ``` ```bash openclaw models list --provider qwen-token-plan openclaw agent --model qwen-token-plan/qwen3.7-plus --message "Reply with: token plan ready" ``` Alibaba 的 OpenClaw 指南使用 `bailian-token-plan` 作為手動自訂供應商。此訂閱外掛會將該識別碼註冊為相容性擁有者，但新的設定應使用 `qwen-token-plan`。完全相符的自訂 `models.providers.bailian-token-plan` 項目會保有其已設定傳輸方式與目錄的擁有權；它絕不會合併至標準 OpenAI 目錄。 Token Plan 僅適用於互動式 OpenClaw 工作階段。請勿將其用於排程工作、無人值守指令碼或應用程式後端。Alibaba 表示，非互動式使用可能會導致訂閱遭暫停或 API 金鑰遭撤銷。 **最適合：**針對 `https://portal.qwen.ai/v1` 使用 Qwen Portal 權杖。 如需專用供應商頁面與遷移注意事項，請參閱 [Qwen OAuth／Portal](/zh-TW/providers/qwen-oauth)。 ```bash openclaw onboard --auth-choice qwen-oauth ``` ```json5 { agents: { defaults: { model: { primary: "qwen-oauth/qwen3.5-plus" }, }, }, } ``` ```bash openclaw models list --provider qwen-oauth ``` `qwen-oauth` 使用與 Qwen Cloud 供應商相同的 `QWEN_API_KEY` 環境變數名稱，但透過 OpenClaw 初始設定完成設定時，會將驗證資料儲存在 `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`。 **管理金鑰：**[home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys) | **文件：**[docs.qwencloud.com](https://docs.qwencloud.com/developer-guides/getting-started/introduction) ## 內建目錄 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 設為預設影片提供者： ```json5 { agents: { defaults: { videoGenerationModel: { primary: "qwen/wan2.6-t2v" }, }, }, } ``` 影片生成限制：每次請求可輸出 1 部影片、最多輸入 1 張圖片（圖片轉影片）、最多輸入 4 部影片（影片轉影片），最長持續時間為 10 秒。支援 `size`、`aspectRatio`、`resolution`、`audio` 和 `watermark`。參考圖片／影片輸入必須使用遠端 http(s) URL；系統會預先拒絕本機檔案路徑，因為 DashScope 影片端點不接受為這些參考資料上傳的本機緩衝區。 如需共用工具參數、提供者選擇和容錯移轉行為，請參閱[影片生成](/zh-TW/tools/video-generation)。 ## 進階設定 `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` 提供）。 ## 相關內容 選擇提供者、模型參照和容錯移轉行為。 共用影片工具參數與提供者選擇。 位於相同 DashScope 平台上的內建 Wan 影片生成提供者。 一般疑難排解與常見問題。