快速开始

Qwen OAuth / 门户

qwen-oauth 是 Qwen Portal 提供商 ID。它面向 Qwen Portal 端点,并通过一个独立的提供商 ID,让较旧的 Qwen OAuth / portal 设置仍可寻址。

当你明确拥有用于 https://portal.qwen.ai/v1 的当前 Qwen Portal 令牌,或正在迁移较旧的 Qwen Portal / Qwen CLI 设置并希望将这些凭证与规范 Qwen Cloud 提供商分开时,请使用此提供商。对于新的 Qwen 用户,它不是推荐的首选项。

对于新的 Qwen Cloud 设置,除非你明确拥有当前 Qwen Portal 令牌,否则请优先使用带有 Standard ModelStudio 端点的 Qwen

设置

通过新手引导提供你的 portal 令牌:

bash
openclaw onboard --auth-choice qwen-oauth

或设置:

bash
export QWEN_API_KEY="<your-qwen-portal-token>" # pragma: allowlist secret

默认值

  • 提供商:qwen-oauth
  • 别名:qwen-portalqwen-cli
  • 基础 URL:https://portal.qwen.ai/v1
  • 环境变量:QWEN_API_KEY
  • API 风格:兼容 OpenAI
  • 默认模型:qwen-oauth/qwen3.5-plus

这与 Qwen 有何不同

OpenClaw 有两个面向 Qwen 的提供商 ID:

提供商 端点系列 适用场景
qwen Qwen Cloud / Alibaba DashScope 和 Coding Plan 端点 新 API key 设置、Standard 按量付费、Coding Plan、多模态 DashScope 功能
qwen-oauth 位于 portal.qwen.ai/v1 的 Qwen Portal 端点 现有 Qwen Portal 令牌和旧版 Qwen OAuth / CLI 设置

两个提供商都使用兼容 OpenAI 的请求形状,但它们是独立的凭证表面。为 qwen-oauth 存储的令牌不应被视为 DashScope 或 ModelStudio 密钥,新的 DashScope 密钥应改用规范的 qwen 提供商。

何时选择 Qwen OAuth / Portal

  • 你已经有一个可用的 Qwen Portal 令牌。
  • 你正在迁移到 OpenClaw 的提供商模型,同时保留旧版 Qwen OAuth 或 Qwen CLI 工作流。
  • 你需要专门测试与 Qwen Portal 端点的兼容性。

对于新设置、更广泛的端点选择、Standard ModelStudio、Coding Plan,以及完整的 Qwen 插件目录,请选择 Qwen

模型

Qwen 插件目录会植入 Qwen Portal 默认值:

  • qwen-oauth/qwen3.5-plus

可用性取决于当前的 Qwen Portal 账户和令牌。如果你的账户改用 ModelStudio / DashScope API 密钥,请配置规范的 qwen 提供商:

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

迁移

旧版 Qwen Portal OAuth 配置文件可能无法刷新。如果 portal 配置文件停止工作,请使用当前令牌重新进行身份验证,或切换到 Standard Qwen 提供商:

bash
openclaw onboard --auth-choice qwen-standard-api-key

Standard 全球 ModelStudio 使用:

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

故障排除

  • Portal OAuth 刷新失败:旧版 Qwen Portal OAuth 配置文件可能无法刷新。请使用当前令牌重新运行新手引导。
  • 端点错误:使用 portal 令牌时,确认模型引用以 qwen-oauth/ 开头。仅对规范 Qwen 提供商使用 qwen/ 引用。
  • QWEN_API_KEY 混淆:两个 Qwen 页面都会提到此环境变量,但新手引导会将凭证存储在选定的提供商 ID 下。当你在同一台机器上同时保留 qwenqwen-oauth 可用时,请优先使用新手引导。

相关

Was this useful?
On this page

On this page