Skip to content

广告 · 本站推荐

腾讯云特惠活动 · 云服务器、数据库、CDN 新用户专享折扣

Qwen OAuth / Portal

qwen-oauth 是 Qwen Portal Provider ID,目标端点是:

text
https://portal.qwen.ai/v1

它主要用于已有 Qwen Portal Token、旧版 Qwen OAuth 或 Qwen CLI 工作流迁移。新用户通常应该优先使用 通义千问 Qwen,也就是标准 ModelStudio / DashScope 路线。


快速设置

通过 onboarding 提供 Portal Token:

bash
openclaw onboard --auth-choice qwen-oauth

也可以用环境变量:

bash
export QWEN_API_KEY="<your-qwen-portal-token>"

默认信息

Providerqwen-oauth
别名qwen-portalqwen-cli
Base URLhttps://portal.qwen.ai/v1
环境变量QWEN_API_KEY
API 风格OpenAI 兼容
默认模型qwen-oauth/qwen3.5-plus

qwen 的区别

Provider端点家族适合场景
qwenQwen Cloud / Alibaba DashScope / Coding Plan新 API Key、标准按量付费、多模态 DashScope 能力
qwen-oauthQwen Portal portal.qwen.ai/v1已有 Portal Token、旧版 OAuth / CLI 迁移

两者虽然都走 OpenAI 兼容请求形状,但认证面不同。qwen-oauth 的 Token 不应该当成 DashScope 或 ModelStudio Key 使用。


迁移建议

如果旧 Portal OAuth Profile 不再可刷新,优先重新认证,或者迁移到标准 Qwen Provider:

bash
openclaw onboard --auth-choice qwen-standard-api-key
openclaw models set qwen/qwen3-coder-plus

标准全球 ModelStudio 端点是:

text
https://dashscope-intl.aliyuncs.com/compatible-mode/v1

故障排查

  • Portal OAuth 刷新失败:旧 OAuth Profile 可能已经不可刷新,重新用当前 Token 做 onboarding。
  • 端点错误:Portal Token 使用 qwen-oauth/ 模型引用;标准 Qwen Key 使用 qwen/
  • QWEN_API_KEY 混淆:两个 Qwen 页面都会提到这个环境变量。若同一台机器同时保留两套凭证,更推荐用 onboarding 按 Provider ID 存储。

用工程视角拆解 AI 智能体框架