概述
通义千问（Qwen）是阿里巴巴旗下的大语言模型，通过 OpenClaw 可以免费使用其 OAuth 认证方式，每日享有高达 2000 次请求额度。对于预算有限的个人开发者来说，这是一个非常有吸引力的选择。
免费额度说明
| 项目 | 详情 |
|---|---|
| 认证方式 | OAuth（设备码授权） |
| 每日免费额度 | 2000 次请求 |
| API 端点 | portal.qwen.ai/v1 |
| 令牌刷新 | 自动 |
配置步骤
使用 qwen-portal-auth 插件
OpenClaw 为 Qwen 提供了专用的 OAuth 认证插件 qwen-portal-auth，通过设备码授权流程完成认证。
openclaw onboard --provider qwen
执行后会看到类似以下的提示：
请在浏览器中访问以下地址完成授权：
https://portal.qwen.ai/device
并输入设备码：ABCD-EFGH
等待授权完成...
在浏览器中打开上述链接，输入设备码并确认授权。授权成功后，OpenClaw 会自动获取并存储访问令牌。
配置文件
{
providers: {
qwen: {
type: "qwen",
plugins: ["qwen-portal-auth"],
baseUrl: "https://portal.qwen.ai/v1"
}
},
agents: {
default: {
model: "qwen/qwen-coder"
}
}
}
模型变体
Qwen 在 OpenClaw 中提供多个专用变体：
Qwen Coder
专为编程任务优化的模型，适合代码生成、重构和调试：
{
agents: {
coder: {
model: "qwen/qwen-coder"
}
}
}
Qwen Vision
支持图像理解的多模态模型，可以分析截图、图表和界面设计：
{
agents: {
vision: {
model: "qwen/qwen-vision"
}
}
}
令牌管理
自动刷新
qwen-portal-auth 插件会自动处理令牌刷新。当访问令牌即将过期时，插件会使用刷新令牌自动获取新的访问令牌，无需人工干预。
从 Qwen Code CLI 同步凭证
如果你已经在 Qwen Code 命令行工具中完成了授权，OpenClaw 可以直接复用这些凭证：
openclaw onboard --provider qwen --sync-from-cli
这样可以避免重复授权操作。
手动检查令牌状态
openclaw auth status --provider qwen
输出示例：
Provider: qwen
Auth Method: OAuth (Device Code)
Token Status: Valid
Expires: 2026-02-13T10:30:00Z
Daily Quota: 1847/2000 remaining
实用场景
作为免费后备模型
Qwen 的免费额度使其成为理想的后备选择：
{
agents: {
default: {
model: "anthropic/claude-sonnet-4-6",
fallback: ["qwen/qwen-coder"]
// Claude 额度用完后自动切换到免费的 Qwen
}
}
}
日常轻量任务
对于简单的代码补全、文档生成等轻量任务，用 Qwen 免费额度即可满足：
{
agents: {
helper: {
model: "qwen/qwen-coder",
description: "用于日常轻量编码任务"
},
heavy: {
model: "anthropic/claude-opus-4-5",
description: "用于复杂推理和大型重构"
}
}
}
常见问题
Q：每日 2000 次额度够用吗？ 对于个人开发者的日常使用来说通常足够。如果需要更高额度，可以联系 Qwen 平台申请或切换到 API Key 付费方式。
Q：设备码授权流程失败怎么办？
确保浏览器能正常访问 portal.qwen.ai，检查设备码是否在有效期内输入（通常有 15 分钟的有效期）。如果仍然失败，尝试清除 OpenClaw 的凭证缓存后重试。
Q：国内访问稳定吗？ 非常稳定。Qwen 是国内服务，API 端点在国内部署，无需代理，延迟极低。
Q：Qwen Coder 和 Qwen Vision 可以同时使用吗？ 可以。它们是不同的模型变体，共享同一个 OAuth 授权和每日额度。在配置中为不同 Agent 指定不同变体即可。