快速开始
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 令牌:
openclaw onboard --auth-choice qwen-oauth或设置:
export QWEN_API_KEY="<your-qwen-portal-token>" # pragma: allowlist secret默认值
- 提供商:
qwen-oauth - 别名:
qwen-portal、qwen-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 提供商:
openclaw onboard --auth-choice qwen-standard-api-keyopenclaw models set qwen/qwen3-coder-plus迁移
旧版 Qwen Portal OAuth 配置文件可能无法刷新。如果 portal 配置文件停止工作,请使用当前令牌重新进行身份验证,或切换到 Standard Qwen 提供商:
openclaw onboard --auth-choice qwen-standard-api-keyStandard 全球 ModelStudio 使用:
https://dashscope-intl.aliyuncs.com/compatible-mode/v1故障排除
- Portal OAuth 刷新失败:旧版 Qwen Portal OAuth 配置文件可能无法刷新。请使用当前令牌重新运行新手引导。
- 端点错误:使用 portal 令牌时,确认模型引用以
qwen-oauth/开头。仅对规范 Qwen 提供商使用qwen/引用。 QWEN_API_KEY混淆:两个 Qwen 页面都会提到此环境变量,但新手引导会将凭证存储在选定的提供商 ID 下。当你在同一台机器上同时保留qwen和qwen-oauth可用时,请优先使用新手引导。