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 以官方外部外掛形式提供,不與核心綁定。請安裝此外掛並重新啟動閘道:

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
  • 標準版(隨用隨付)

    **最適合:**透過標準版 Model Studio 端點使用隨用隨付存取,包括 Coding Plan 不提供的 qwen3.7-maxqwen3.6-flash

  • 取得 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(團隊版)

    **最適合:**透過 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 "Reply with: token plan ready"
  • Qwen OAuth/Portal

    **最適合:**針對 https://portal.qwen.ai/v1 使用 Qwen Portal 權杖。

    如需專用供應商頁面與遷移注意事項,請參閱 Qwen OAuth/Portal

  • 提供 Portal 權杖

    bash
    openclaw onboard --auth-choice qwen-oauth
  • 設定預設模型

    json5
    {  agents: {    defaults: {      model: { primary: "qwen-oauth/qwen3.5-plus" },    },  },}
  • 確認模型可用

    bash
    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-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 會將 minimalhigh 對應至服務的 high 推理強度,並將 xhighmax 對應至 max。GLM 5.2 接受從 minimalmax 的完整範圍;GLM 5.1 和 GLM 5 接受至 xhigh,且三者皆預設為 high。其他混合模型會遵循所要求的開啟/關閉狀態。

    多模態附加功能

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

    • 透過 qwen-vl-max-latest 進行圖片與影片理解
    • 透過 wan2.6-t2v(預設)、wan2.6-i2vwan2.6-r2vwan2.6-r2v-flashwan2.7-r2v 進行 Wan 影片生成

    媒體理解功能會根據已設定的 Qwen 驗證資訊自動解析,無須額外設定。若要使用媒體理解功能,請確保使用 Standard(隨用隨付)端點。

    若要將 Qwen 設為預設影片提供者:

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

    影片生成限制:每次請求可輸出 1 部影片、最多輸入 1 張圖片(圖片轉影片)、最多輸入 4 部影片(影片轉影片),最長持續時間為 10 秒。支援 sizeaspectRatioresolutionaudiowatermark。參考圖片/影片輸入必須使用遠端 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 端點對其中任一模型傳回「不支援的模型」錯誤,請切換至對應的 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_KEYQWEN_TOKEN_PLAN_API_KEY(例如放在 ~/.openclaw/.env 中,或透過 env.shellEnv 提供)。

    相關內容

    Was this useful?
    On this page

    On this page