Qwen (通义千问)
Qwen（通义千问）为 Qwen Coder 和 Qwen Vision 模型提供免费层 OAuth 访问，每天提供 2000 次请求配额。
免费层配额受 Qwen 速率限制约束，适合轻度使用和测试场景。
快速开始
启用插件
首先启用 Qwen OAuth 认证插件：openclaw plugins enable qwen-portal-auth
完成认证
运行 OAuth 认证流程：openclaw models auth login --provider qwen-portal --set-default
设置默认模型
认证完成后，设置 Qwen 模型为默认：{
"agents": {
"defaults": {
"model": {
"primary": "qwen-portal/coder-model"
}
}
}
}
可用模型
Qwen 通过 OAuth 提供两个主要模型：
Qwen Coder
适用于代码生成、分析和编程任务的专业模型。
{
"agents": {
"defaults": {
"model": {
"primary": "qwen-portal/coder-model"
}
}
}
}
Qwen Vision
支持图像理解和视觉任务的多模态模型。
{
"agents": {
"defaults": {
"model": {
"primary": "qwen-portal/vision-model"
}
}
}
}
模型切换
您可以使用命令行快速切换模型：
openclaw models set qwen-portal/coder-model
重用 Qwen Code CLI 登录
如果您已经使用 Qwen Code CLI 登录过，OpenClaw 会自动从 ~/.qwen/oauth_creds.json 同步凭据。
即使 OpenClaw 可以重用 Qwen Code CLI 的凭据，您仍然需要在配置中创建 models.providers.qwen-portal 条目。使用上述登录命令即可自动创建。
凭据同步流程
-
使用 Qwen Code CLI 登录：
-
OpenClaw 在加载认证存储时会自动同步凭据
-
运行 OpenClaw 登录命令创建提供商条目：
openclaw models auth login --provider qwen-portal --set-default
认证配置
OAuth 流程
Qwen 使用设备码 OAuth 流程，无需在浏览器中复制粘贴长 token。
启动认证
openclaw models auth login --provider qwen-portal
浏览器验证
在浏览器中访问显示的 URL，输入设备码完成认证。
自动完成
认证成功后，OpenClaw 自动获取访问令牌并保存。
自动令牌刷新
OpenClaw 会自动刷新过期的访问令牌，无需手动干预。
openclaw models auth login --provider qwen-portal --set-default
配置选项
基础配置
认证完成后，配置会自动写入 models.json：
{
"models": {
"providers": {
"qwen-portal": {
"baseUrl": "https://portal.qwen.ai/v1",
"api": "openai-completions"
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "qwen-portal/coder-model"
}
}
}
}
自定义端点
如果 Qwen 提供了不同的端点，可以通过配置覆盖：
{
"models": {
"providers": {
"qwen-portal": {
"baseUrl": "https://custom-endpoint.qwen.ai/v1",
"api": "openai-completions"
}
}
}
}
完整配置示例
{
"agents": {
"defaults": {
"model": {
"primary": "qwen-portal/coder-model"
}
}
}
}
配额管理
免费层限制
- 每日请求数： 2000 次
- 速率限制： 受 Qwen 平台限制
- 上下文窗口： 根据模型而定
监控使用情况
您可以通过命令查看当前认证状态：
# 查看简单状态
openclaw models status
# 查看详细 JSON 信息
openclaw models status --json
故障排除
OAuth 认证失败
问题： 设备码认证流程失败。
解决方案：
- 确保网络可以访问
portal.qwen.ai
- 检查是否有代理或防火墙阻止 OAuth 请求
- 重新运行认证流程：
openclaw models auth login --provider qwen-portal --set-default
令牌刷新失败
问题： 访问令牌过期且刷新失败。
解决方案：
- 检查网络连接
- 重新运行 OAuth 登录：
openclaw models auth login --provider qwen-portal --set-default
找不到 qwen-portal 提供商
问题： OpenClaw 无法识别 qwen-portal 提供商。
解决方案：
- 确认插件已启用：
- 如果插件未启用，运行：
openclaw plugins enable qwen-portal-auth
openclaw gateway restart
速率限制错误
问题： 超过每日配额限制。
解决方案：
- 等待配额重置（通常在每日 00:00 UTC）
- 考虑配置故障切换模型：
{
"agents": {
"defaults": {
"model": {
"primary": "qwen-portal/coder-model",
"fallbacks": ["openai/gpt-5.4"]
}
}
}
}
访问被撤销
问题： Qwen 平台撤销了访问权限。
解决方案：
- 重新运行 OAuth 认证流程
- 检查 Qwen 账户状态
- 如有必要，联系 Qwen 支持
最佳实践
模型选择
使用 Qwen Coder 模型处理代码生成、分析和编程相关任务：{
"agents": {
"defaults": {
"model": {
"primary": "qwen-portal/coder-model"
}
}
}
}
使用 Qwen Vision 模型处理图像理解和视觉相关任务：{
"agents": {
"defaults": {
"model": {
"primary": "qwen-portal/vision-model"
}
}
}
}
为不同 agent 配置不同模型：{
"agents": {
"defaults": {
"model": {
"primary": "qwen-portal/coder-model"
}
},
"list": [
{
"id": "coding-assistant",
"model": {
"primary": "qwen-portal/coder-model"
}
},
{
"id": "vision-assistant",
"model": {
"primary": "qwen-portal/vision-model"
}
}
]
}
}
配额优化
- 使用故障切换： 配置备用模型避免配额耗尽时服务中断
- 合理分配： 为不同任务配置不同 agent，避免单一模型配额快速消耗
- 监控使用： 定期检查
openclaw models status 了解使用情况
相关资源
