通义千问（Qwen）是阿里云推出的大型语言模型系列，凭借出色的中文表现、极具竞争力的定价和高达 100 万 Token 的超长上下文窗口，在 OpenClaw 中文社区中拥有大量用户。然而，随着 OpenClaw 版本迭代，Qwen 的接入方式发生了重要变化：旧版 qwen-portal OAuth 集成已被彻底移除，必须迁移到阿里云百炼（DashScope）标准端点。本文提供 2026 年 4 月最新的完整配置教程。更多资源请访问 OpenClaw 中文版官网。

一、重要变更：qwen-portal OAuth 已废弃

发生了什么？

在 OpenClaw v2026.3.23 之前，部分用户通过 qwen-portal OAuth 方式免费接入 Qwen（使用 portal.qwen.ai 端点）。这一集成方式已于 v2026.3.24 中被正式移除（PR #52709）：

Providers/Qwen: remove the deprecated qwen-portal-auth OAuth integration for portal.qwen.ai; migrate to Model Studio with openclaw onboard --auth-choice modelstudio-api-key.

迁移路径

现在，所有 Qwen 用户都需要通过 阿里云百炼（Alibaba Cloud Model Studio / DashScope） 的 API Key 方式接入，分为两类：

  • 标准按量计费：在阿里云控制台创建 API Key，按 Token 用量计费
  • Coding Plan（编程计划）：包月订阅制，含固定请求配额，适合高频使用场景

同时，v2026.3.23 还对 Qwen 服务商做了重大改进：正式新增了中国（北京）和全球（新加坡）两个标准按量计费端点，使 DashScope 按量计费用户无需任何绕过配置即可使用。

二、获取 DashScope API Key

国际版（推荐国内出海用户或全球用户）

  1. 访问 www.alibabacloud.com，注册或登录阿里云国际账号
  2. 在控制台搜索并开通 「Model Studio（百炼）」
  3. 进入 「API Key 管理」，点击「创建 API Key」
  4. 选择工作空间（默认工作空间可调用所有模型），创建后立即复制 Key（格式：sk-xxxxxxxxxxxx）
  5. 在账单页面确认账户余额充足（新用户通常有免费额度）

国内版（推荐中国大陆用户）

  1. 访问 bailian.aliyun.com，登录阿里云账号（支持支付宝验证）
  2. 开通百炼服务，进入「API Key 管理」创建 Key
  3. 使用北京地区端点：https://dashscope.aliyuncs.com/compatible-mode/v1

关键注意：不同地区的 API Key 相互独立，不能跨地区使用。在新加坡创建的 Key 无法用于北京端点，反之亦然。配置文件中的 baseUrl、apiKey 和 models 必须属于同一地区。

三、三地区端点一览

地区 Base URL 适合人群
新加坡（国际） https://dashscope-intl.aliyuncs.com/compatible-mode/v1 国际用户、中国出海用户（延迟低）
美国弗吉尼亚（国际） https://dashscope-us.aliyuncs.com/compatible-mode/v1 北美用户（注意：不支持 qwen3-coder-next 等部分模型）
中国北京（国内） https://dashscope.aliyuncs.com/compatible-mode/v1 中国大陆用户（直连，延迟最低；支持第三方文本生成模型）
Coding Plan（全球） https://coding-intl.dashscope.aliyuncs.com/v1 Coding Plan 订阅用户（Key 格式：sk-sp-…）

四、方式一：引导向导快速配置

v2026.3.23 之后，Qwen DashScope 标准接入已集成到 OpenClaw 引导向导中：

# 国际端点（新加坡/弗吉尼亚）
openclaw onboard --auth-choice modelstudio-api-key

# 国内端点（中国北京）
openclaw onboard --auth-choice modelstudio-api-key-cn

# Coding Plan
openclaw onboard --auth-choice modelstudio-coding-plan

在向导中依次完成：

  1. 选择端点地区
  2. 粘贴 DashScope API Key
  3. 选择默认模型（建议 qwen3.5-plus 或 qwen-plus）
  4. 完成其他配置步骤

五、方式二：手动编辑 openclaw.json（推荐完整配置）

国际端点（新加坡）—— 标准按量计费

{
  "env": {
    "DASHSCOPE_API_KEY": "sk-你的DashScope密钥"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
        "apiKey": "${DASHSCOPE_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "Qwen3.5 Plus（通用多模态）",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0.0000004, "output": 0.0000012 },
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "qwen3-max-2026-01-23",
            "name": "Qwen3 Max（旗舰推理）",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0.0000012, "output": 0.000006 },
            "contextWindow": 262144,
            "maxTokens": 65536,
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "qwen3-coder-next",
            "name": "Qwen3 Coder Next（代码专用）",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 262144,
            "maxTokens": 65536
          },
          {
            "id": "qwen-plus",
            "name": "Qwen Plus（平衡版）",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0.0000004, "output": 0.0000012 },
            "contextWindow": 1000000,
            "maxTokens": 65536
          },
          {
            "id": "qwen-turbo",
            "name": "Qwen Turbo（高速版）",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0.0000002, "output": 0.0000006 },
            "contextWindow": 1000000,
            "maxTokens": 65536
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus",
        "fallbacks": [
          "bailian/qwen-plus",
          "bailian/qwen-turbo"
        ]
      },
      "models": {
        "bailian/qwen3.5-plus": { "alias": "qwen" },
        "bailian/qwen3-max-2026-01-23": { "alias": "qwen-max" },
        "bailian/qwen3-coder-next": { "alias": "qwen-coder" },
        "bailian/qwen-plus": { "alias": "qwen-plus" },
        "bailian/qwen-turbo": { "alias": "qwen-turbo" }
      }
    }
  }
}

国内端点（中国北京）—— 标准按量计费

{
  "env": {
    "DASHSCOPE_API_KEY": "sk-你的DashScope国内密钥"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "${DASHSCOPE_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "Qwen3.5 Plus",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "qwen3-max-2026-01-23",
            "name": "Qwen3 Max",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 262144,
            "maxTokens": 65536,
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "qwen-plus",
            "name": "Qwen Plus",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 1000000,
            "maxTokens": 65536
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus"
      },
      "models": {
        "bailian/qwen3.5-plus": { "alias": "qwen" },
        "bailian/qwen3-max-2026-01-23": { "alias": "qwen-max" },
        "bailian/qwen-plus": { "alias": "qwen-plus" }
      }
    }
  }
}

Coding Plan 配置（包月订阅制）

{
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "apiKey": "sk-sp-你的CodingPlan专用密钥",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "qwen3.5-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "qwen3-max-2026-01-23",
            "name": "qwen3-max-2026-01-23",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 262144,
            "maxTokens": 65536,
            "compat": { "thinkingFormat": "qwen" }
          },
          {
            "id": "qwen3-coder-next",
            "name": "qwen3-coder-next",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 262144,
            "maxTokens": 65536
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "bailian/qwen3.5-plus" },
      "models": {
        "bailian/qwen3.5-plus": {},
        "bailian/qwen3-max-2026-01-23": {},
        "bailian/qwen3-coder-next": {}
      }
    }
  }
}

六、四个关键配置细节（必读）

细节一：reasoning 必须设为 false

这是最容易踩的坑。Qwen 模型在 DashScope 端点上，所有模型的 reasoning 字段都必须设为 false。如果设为 true 或省略，API 响应将为空。

// ❌ 错误：不要设 reasoning: true
{
  "id": "qwen3-max-2026-01-23",
  "reasoning": true    // 会导致响应为空
}

// ✅ 正确
{
  "id": "qwen3-max-2026-01-23",
  "reasoning": false
}

细节二：服务商名称决定模型引用格式

如果配置文件中将服务商命名为 bailian，则在模型引用时必须使用 bailian/qwen3.5-plus，而不能简写为 qwen3.5-plus。服务商名称和模型路径必须保持一致：

// 服务商名为 bailian
"providers": { "bailian": { ... } }

// 则 agents 中引用必须是：
"model": { "primary": "bailian/qwen3.5-plus" }

// 而不是：
"model": { "primary": "qwen3.5-plus" }   // ❌ 会报 Unknown model 错误

细节三：模型 ID 拼写必须精确

Qwen 模型 ID 拼写有一些容易混淆的地方：

  • qwen3.5-plus（含小数点，正确）
  • qwen-3.5-plus（含连字符，错误）
  • qwen3-max-2026-01-23（带版本日期，这是确定的快照版本）
  • qwen3-max（不带日期，指向最新版本，可能随模型更新而变化）

细节四：思维模式（Thinking）需要 compat 配置

Qwen3 系列支持思维模式（类似 o1 的深度推理），但需要额外的 compat 配置：

{
  "id": "qwen3.5-plus",
  "reasoning": false,
  "compat": {
    "thinkingFormat": "qwen"    // 启用 Qwen 格式思维模式
  }
}

# 在聊天中启用思维模式（需要 OpenClaw v2026.03.02+）
/think high

启用后，Qwen 会先进行内部推理（thinking），再给出最终答案，适合需要深度分析的场景。

七、重启并验证

# 保存配置后重启 Gateway
openclaw daemon restart

# 验证模型列表中包含 Qwen 模型
openclaw models list | grep bailian

# 测试模型可用性
openclaw models status

# 发送测试消息
# 在聊天中：你好，请介绍一下你自己
# 或通过别名切换：/model qwen

# 使用 curl 直接测试端点连通性（国内端点示例）
curl -X POST https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \
  -H "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"model": "qwen3.5-plus", "messages": [{"role": "user", "content": "你好"}]}'

八、Qwen 模型选型指南

模型 上下文 输入价格 适用场景
qwen3.5-plus 100 万 Token $0.40/M 日常首选，通用对话 + 多模态输入，支持思维模式
qwen3-max-2026-01-23 26.2 万 Token $1.20/M 复杂推理、专业分析，支持思维模式
qwen3-coder-next 26.2 万 Token — 代码生成与调试专用，编程效果最佳
qwen-plus 100 万 Token $0.40/M 兼顾性能与成本，大多数个人助手场景
qwen-turbo 100 万 Token $0.20/M 速度优先，轻量任务、高频心跳任务

社区建议：日常使用从 qwen3.5-plus 开始——1M Token 上下文、支持图文输入、思维模式可按需启用，是综合性价比最高的选择。代码任务切换 qwen3-coder-next，复杂分析切换 qwen3-max。

九、常见报错速查

报错：401 Unauthorized

API Key 无效、已过期，或账户有欠费。登录 bailian.aliyun.com（国内）或 www.alibabacloud.com（国际）检查 Key 状态和账户余额。注意：Key 是否包含多余的空格——从浏览器复制时容易夹带。

报错：响应为空或 AI 没有内容回复

90% 的概率是 reasoning: true 的问题。检查配置文件，确认所有 Qwen 模型的 reasoning 字段都设为 false。

报错：Unknown model: qwen3.5-plus

模型引用格式错误，缺少服务商前缀。检查 agents.defaults.models 和 model.primary，确认引用格式为 bailian/qwen3.5-plus（包含服务商名）。

报错：模型不支持（某地区）

并非所有模型在所有地区都可用。例如，qwen3-coder-next 在美国弗吉尼亚地区不可用，第三方文本生成模型只在中国北京地区可用。检查 Base URL 是否与模型所在地区匹配。

报错：Coding Plan 403 / 配额超限

Coding Plan 有每小时/周/月的请求配额。超限后会收到 “allocated quota exceeded” 错误，等待配额重置或升级到 Pro 计划。同时检查 API Key 是否是 Coding Plan 专用格式（以 sk-sp- 开头），不可与标准 Key 混用。

报错：连接被拒绝或超时

如果本地有 VPN 或代理，可能会拦截到 DashScope 端点的请求。关闭 VPN 或将 dashscope.aliyuncs.com 添加到代理白名单。也可检查 ~/.openclaw/agents/main/agent/models.json 中是否缓存了错误的 Base URL。

十、旧版 qwen-portal 配置迁移指南

如果你的 openclaw.json 中还有旧版 qwen-portal 配置，执行以下步骤迁移：

# 第一步：检查旧配置
openclaw config get models.providers.qwen-portal

# 如果有输出，执行清理
# 第二步：运行 doctor 清理旧配置
openclaw doctor --fix

# 第三步：按本文第五节添加新的 bailian 服务商配置

# 第四步：重启验证
openclaw daemon restart
openclaw models list | grep bailian

注意：v2026.3.24 起，openclaw doctor 会对超过两个月的旧配置项直接报 validation error 而不是自动迁移。如果出现旧 key 验证失败，手动删除 openclaw.json 中的 qwen-portal 相关条目即可。

总结

OpenClaw 接入通义千问 Qwen 的关键配置三要点：

  1. 使用 DashScope 标准端点：旧版 qwen-portal OAuth 已彻底废弃，必须迁移到 bailian 服务商 + DashScope API Key
  2. 所有模型 reasoning: false：Qwen 在 DashScope 端点上不支持 OpenClaw 原生推理标志，设为 true 会导致响应为空
  3. Base URL、API Key、模型必须属于同一地区：国内用北京端点，国际用新加坡或美国端点，不可混用

完成配置后，你的 OpenClaw 助手将拥有通义千问优秀的中文能力、100 万 Token 超长上下文，以及国内直连的低延迟体验。想了解更多 OpenClaw 国产模型接入教程，欢迎访问 OpenClaw 中文版官网。