通义千问（Qwen）

通义千问（Qwen）是阿里云推出的大语言模型系列。OpenClaw 支持通过 Qwen Portal 插件实现 OAuth 免费额度认证，每日可免费使用 2000 次请求，无需绑定支付方式。

免费额度 OAuth 认证（推荐）

第一步：启用 Qwen Portal 插件

openclaw plugins enable qwen-portal-auth

第二步：登录并设置默认模型

openclaw models auth login --provider qwen-portal --set-default

执行后会打开浏览器，完成阿里云账号登录即可。登录成功后，OpenClaw 会自动获取并管理认证 Token。

第三步：验证配置

# 查看当前默认模型
openclaw models default get

# 测试对话
openclaw chat "你好，请介绍一下通义千问"

模型 ID

模型 ID	说明
qwen-portal/coder-model	编程优化模型，适合代码生成和分析
qwen-portal/vision-model	视觉模型，支持图片理解

使用示例：

# 使用编程模型
openclaw models default set qwen-portal/coder-model

# 使用视觉模型
openclaw chat --model qwen-portal/vision-model "描述这张图片的内容"

复用 Qwen Code CLI 登录

如果你已安装并登录了通义灵码（Qwen Code CLI），OpenClaw 可以直接复用其认证信息：

# 自动检测并复用 Qwen Code CLI 的登录状态
openclaw models auth login --provider qwen-portal --reuse-session

Token 管理

• 自动刷新：OAuth Token 到期时，OpenClaw 会自动刷新，无需手动操作
• 手动刷新：如遇认证失败，可手动重新登录

  openclaw models auth login --provider qwen-portal

• 查看 Token 状态：

  openclaw models auth status --provider qwen-portal

使用阿里云百炼 API Key（付费）

除了免费 OAuth 方式，你也可以使用阿里云百炼平台的 API Key 获取更高的配额：

获取 API Key

1. 前往 阿里云百炼控制台
2. 注册并实名认证
3. 在左侧菜单「API Key 管理」中创建 API Key
4. 复制 API Key

配置 OpenClaw

// ~/.openclaw/config.json
{
  "models": {
    "providers": {
      "qwen": {
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      }
    }
  }
}

百炼平台可用模型

模型 ID	说明	上下文窗口
qwen-max	最强版本	32K
qwen-plus	均衡性能与成本	128K
qwen-turbo	快速响应	128K
qwen-long	超长文本处理	1M
qwen-vl-max	视觉理解模型	32K
qwen2.5-coder-32b-instruct	编程专用模型	128K

免费额度说明

项目	说明
每日请求次数	2000 次
认证方式	阿里云账号 OAuth
是否需要绑定支付	否
支持的模型	coder-model、vision-model
Token 有效期	自动刷新

故障排查

OAuth 登录失败

• 确认浏览器可正常打开登录页面
• 尝试清除浏览器 Cookie 后重新登录
• 检查网络连接是否正常

额度用尽

• 免费额度每日零点（UTC+8）重置
• 如需更多额度，可切换为阿里云百炼 API Key 付费模式

模型响应慢

• 免费额度的 QPS（每秒查询数）有限制
• 高峰时段可能排队，请耐心等待
• 付费模式可获得更高优先级

🇨🇳 中国用户须知

• 零成本起步：通义千问 OAuth 免费额度是国内用户体验 OpenClaw 的最佳入口，无需任何费用
• 无需代理：阿里云服务在国内可直接访问，速度极快
• 企业用户：建议使用阿里云百炼 API Key 模式，可获得更高的配额和 SLA 保障
• 学生优惠：阿里云百炼对学生账号有额外的免费额度