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

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
  • Standard(隨用隨付)

    **最適合:**透過 Standard 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 "回覆: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-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 外掛僅在 Standard DashScope 端點上提供多模態功能,不支援 Coding Plan 端點:

    • 影像與影片理解,透過 qwen3.6-plus
    • Wan 影片生成,透過 wan2.6-t2v(預設)、wan2.6-i2vwan2.6-r2vwan2.6-r2v-flashwan2.7-r2v

    系統會根據已設定的 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