Skip to content
OpenClaw Docs

Qwen

OpenClaw 現在將 Qwen 視為具有標準 ID qwen 的一等內建提供者。此內建提供者以 Qwen Cloud / Alibaba DashScope 和 Coding Plan 端點為目標，保留舊版 modelstudio ID 作為相容性 別名，並將 Qwen Portal 權杖流程公開為提供者 qwen-oauth。

  • 提供者：qwen
  • Portal 提供者：qwen-oauth
  • 首選環境變數：QWEN_API_KEY
  • 為相容性也接受：MODELSTUDIO_API_KEY、DASHSCOPE_API_KEY
  • API 風格： OpenAI 相容

開始使用

Section titled “開始使用”

選擇您的方案類型並依照設定步驟操作。

最適用於： 透過 Qwen Coding Plan 進行訂閱制存取。

  1. 取得您的 API 金鑰

    從 home.qwencloud.com/api-keys 建立或複製 API 金鑰。

  2. 執行上架流程

    若是針對 全球 端點：

    Terminal window
    openclaw onboard --auth-choice qwen-api-key

    若是針對 中國 端點：

    Terminal window
    openclaw onboard --auth-choice qwen-api-key-cn

  3. 設定預設模型

    {
      agents: {
        defaults: {
          model: { primary: "qwen/qwen3.5-plus" },
        },
      },
    }

  4. 驗證模型是否可用

    Terminal window
    openclaw models list --provider qwen

方案類型與端點

Section titled “方案類型與端點”
方案區域驗證選擇端點
標準方案中國qwen-standard-api-key-cndashscope.aliyuncs.com/compatible-mode/v1
標準方案全球qwen-standard-api-keydashscope-intl.aliyuncs.com/compatible-mode/v1
編碼方案中國qwen-api-key-cncoding.dashscope.aliyuncs.com/v1
編碼方案全球qwen-api-keycoding-intl.dashscope.aliyuncs.com/v1
Qwen Portal全球qwen-oauthportal.qwen.ai/v1

此提供者會根據您的驗證選擇自動選取端點。標準選項使用 qwen-* 系列；modelstudio-* 僅保留作為相容性用途。您可以在設定中使用自訂 baseUrl 來覆寫。

內建目錄

Section titled “內建目錄”

OpenClaw 目前隨附此捆綁的 Qwen 目錄。設定的目錄具備端點感知功能：編碼方案設定會省略僅已知可在標準端點上運作的模型。

模型參照輸入語境備註
qwen/qwen3.5-plus文字、圖片1,000,000預設模型
qwen/qwen3.6-plus文字、圖像1,000,000當您需要此模型時，建議優先使用 Standard 端點
qwen/qwen3-max-2026-01-23文字262,144Qwen 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,752GLM
qwen/glm-4.7文字202,752GLM
qwen/kimi-k2.5文字、圖像262,144透過阿里雲存取 Moonshot AI
qwen-oauth/qwen3.5-plus文字、圖像1,000,000Qwen Portal 預設值

思考控制

Section titled “思考控制”

對於已啟用推理的 Qwen Cloud 模型，捆綁提供者會將 OpenClaw 思考等級 對應至 DashScope 的頂層 enable_thinking 請求旗標。停用 思考會發送 enable_thinking: false；其他思考等級則會發送 enable_thinking: true。

多模態附加功能

Section titled “多模態附加功能”

qwen 外掛程式也在 Standard DashScope 端點（而非 Coding Plan 端點）上公開多模態功能：

  • 透過 qwen-vl-max-latest 理解影片
  • 透過 wan2.6-t2v（預設）、wan2.6-i2v、wan2.6-r2v、wan2.6-r2v-flash、wan2.7-r2v 進行 Wan 影片生成

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

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

進階設定

Section titled “進階設定”
圖像與視訊理解

內建的 Qwen 外掛程式會在 標準 DashScope 端點（而非 Coding Plan 端點）上 註冊圖像與視訊的媒體理解功能。

屬性值
模型qwen-vl-max-latest
支援的輸入圖像、視訊

媒體理解功能會從已設定的 Qwen 驗證資訊自動解析 — 不需要 額外的設定。請確保您使用的是標準（隨用隨付） 端點以獲得媒體理解支援。

Qwen 3.6 Plus 可用性

qwen3.6-plus 可在標準（隨用隨付）Model Studio 端點上使用：

  • 中國：dashscope.aliyuncs.com/compatible-mode/v1
  • 全球：dashscope-intl.aliyuncs.com/compatible-mode/v1

如果 Coding Plan 端點對於 qwen3.6-plus 傳回「不支援的模型」錯誤，請改用標準（隨用隨付）而非 Coding Plan 端點/金鑰組合。

OpenClaw 的內建 Qwen 型錄不會在 Coding Plan 端點上宣佈 qwen3.6-plus，但會在 Coding Plan baseUrls 上接受明確設定的 qwen/qwen3.6-plus 項目（位於 models.providers.qwen.models 之下），因此如果 Aliyun 在您的訂閱中啟用了該模型，您可以選擇啟用該模型。上游 API 仍會決定呼叫是否成功。

功能計畫

qwen 外掛程式正被定位為完整 Qwen Cloud 表面的供應商首頁，而不僅僅是編碼/文字模型。

  • 文字/聊天模型： 現已內建
  • 工具呼叫、結構化輸出、思考： 繼承自 OpenAI 相容傳輸
  • 圖像生成： 計畫在 provider-plugin 層級實現
  • 圖像/視訊理解： 現已在標準端點上內建
  • 語音/音訊： 計畫在 provider-plugin 層級實現
  • 記憶嵌入/重排序： 計畫透過 embedding adapter 表面實現
  • 視訊生成： 現已透過共用的視訊生成功能內建
視訊生成詳情

針對視訊生成，OpenClaw 會在提交任務前，將設定的 Qwen 區域對應至相應的 DashScope AIGC 主機：

  • Global/Intl: https://dashscope-intl.aliyuncs.com
  • China: https://dashscope.aliyuncs.com

這意味著一個指向 Coding Plan 或標準 Qwen 主機的常規 models.providers.qwen.baseUrl 仍然能夠將視訊生成保持在 正確區域的 DashScope 視訊端點上。

目前內建 Qwen 視訊生成的限制：

  • 每次請求最多輸出 1 個視訊
  • 最多 1 張輸入圖片
  • 最多 4 個輸入視訊
  • 長度最長 10 秒
  • 支援 size、aspectRatio、resolution、audio 和 watermark
  • 參考圖片/視訊模式目前需要 遠端 http(s) URL。本地 檔案路徑會在一開始就被拒絕，因為 DashScope 視訊端點不會針對這些參考接受 上傳的本地緩衝區。
串流使用相容性

原生 Model Studio 端點在共享的 openai-completions 傳輸上宣佈支援串流使用相容性。 OpenClaw 現在會關閉端點功能，因此指向相同原生主機且與 DashScope 相容的自訂供應商 ID 會繼承相同的串流使用行為，而無需特別要求使用內建的 qwen 供應商 ID。

原生串流使用相容性同時適用於 Coding Plan 主機和標準的 DashScope 相容主機：

  • 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
多模態端點區域

多模態介面（視訊理解和 Wan 視訊生成）使用的是 標準 DashScope 端點，而非 Coding Plan 端點：

  • Global/Intl Standard base URL: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
  • China Standard base URL: https://dashscope.aliyuncs.com/compatible-mode/v1
環境與守護程式設定

如果 Gateway 以守護程式 (launchd/systemd) 執行，請確保 QWEN_API_KEY 可供該程序使用 (例如，在 ~/.openclaw/.env 中或透過 env.shellEnv)。

相關

Section titled “相關”
模型選擇

選擇提供者、模型參照和故障轉移行為。

視訊生成

共用的視訊工具參數和提供者選擇。

Alibaba (ModelStudio)

舊版 ModelStudio 提供者與移駁注意事項。

疑難排解

一般疑難排解與常見問題。