> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Qwen OAuth / Portale

`qwen-oauth` è l'id provider di Qwen Portal. Punta all'endpoint Qwen Portal
e mantiene raggiungibili le configurazioni Qwen OAuth / portal meno recenti tramite un
id provider distinto.

Usa questo provider quando hai specificamente un token Qwen Portal corrente per
`https://portal.qwen.ai/v1`, oppure quando stai migrando una configurazione Qwen Portal /
Qwen CLI meno recente e vuoi mantenere quelle credenziali separate dal provider canonico
Qwen Cloud. Non è la prima scelta consigliata per i nuovi utenti Qwen.

Per le nuove configurazioni Qwen Cloud, preferisci [Qwen](/it/providers/qwen) con l'endpoint Standard
ModelStudio, a meno che tu non abbia specificamente un token Qwen Portal corrente.

## Configurazione

Fornisci il tuo token portal tramite l'onboarding:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice qwen-oauth
```

Oppure imposta:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export QWEN_API_KEY="<your-qwen-portal-token>" # pragma: allowlist secret
```

## Valori predefiniti

* Provider: `qwen-oauth`
* Alias: `qwen-portal`, `qwen-cli`
* URL di base: `https://portal.qwen.ai/v1`
* Variabile d'ambiente: `QWEN_API_KEY`
* Stile API: compatibile con OpenAI
* Modello predefinito: `qwen-oauth/qwen3.5-plus`

## Differenze rispetto a Qwen

OpenClaw ha due id provider rivolti a Qwen:

| Provider     | Famiglia di endpoint                                  | Ideale per                                                                                                   |
| ------------ | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `qwen`       | Endpoint Qwen Cloud / Alibaba DashScope e Coding Plan | Nuove configurazioni con chiave API, Standard pay-as-you-go, Coding Plan, funzionalità multimodali DashScope |
| `qwen-oauth` | Endpoint Qwen Portal su `portal.qwen.ai/v1`           | Token Qwen Portal esistenti e configurazioni Qwen OAuth / CLI legacy                                         |

Entrambi i provider usano forme di richiesta compatibili con OpenAI, ma sono superfici
di autenticazione separate. Un token archiviato per `qwen-oauth` non deve essere trattato
come una chiave DashScope o ModelStudio, e una nuova chiave DashScope deve invece usare
il provider canonico `qwen`.

## Quando scegliere Qwen OAuth / Portal

* Hai già un token Qwen Portal funzionante.
* Stai preservando un flusso di lavoro Qwen OAuth o Qwen CLI legacy durante il passaggio al
  modello di provider di OpenClaw.
* Devi testare specificamente la compatibilità con l'endpoint Qwen Portal.

Scegli [Qwen](/it/providers/qwen) per una nuova configurazione, scelte di endpoint più ampie, Standard
ModelStudio, Coding Plan e il catalogo completo del plugin Qwen.

## Modelli

Il catalogo del plugin Qwen inizializza il valore predefinito di Qwen Portal:

* `qwen-oauth/qwen3.5-plus`

La disponibilità dipende dall'account e dal token Qwen Portal correnti. Se il tuo
account usa invece chiavi API ModelStudio / DashScope, configura il provider canonico
`qwen`:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice qwen-standard-api-key
openclaw models set qwen/qwen3-coder-plus
```

## Migrazione

I profili OAuth Qwen Portal legacy potrebbero non essere aggiornabili. Se un profilo portal
smette di funzionare, autenticati di nuovo con un token corrente oppure passa al provider
Qwen Standard:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice qwen-standard-api-key
```

ModelStudio globale Standard usa:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
https://dashscope-intl.aliyuncs.com/compatible-mode/v1
```

## Risoluzione dei problemi

* Errori di aggiornamento di Portal OAuth: i profili OAuth Qwen Portal legacy potrebbero non essere
  aggiornabili. Esegui di nuovo l'onboarding con un token corrente.
* Errori di endpoint errato: verifica che il riferimento del modello inizi con `qwen-oauth/` quando
  usi un token portal. Usa riferimenti `qwen/` solo per il provider canonico Qwen.
* Confusione su `QWEN_API_KEY`: entrambe le pagine Qwen menzionano questa variabile d'ambiente, ma l'onboarding
  archivia le credenziali sotto l'id provider selezionato. Preferisci l'onboarding quando
  mantieni disponibili sia `qwen` sia `qwen-oauth` sulla stessa macchina.

## Correlati

* [Qwen](/it/providers/qwen)
* [Alibaba Model Studio](/it/providers/alibaba)
* [Provider di modelli](/it/concepts/model-providers)
* [Tutti i provider](/it/providers/index)