OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Alibaba Model Studio

Il plugin alibaba incluso registra un provider di generazione video per i modelli Wan su Alibaba Model Studio (il nome internazionale di DashScope). È abilitato per impostazione predefinita; è necessaria solo una chiave API.

Proprietà Valore
ID del provider alibaba
Plugin incluso, enabledByDefault: true
Variabili di ambiente per l'autenticazione MODELSTUDIO_API_KEY → DASHSCOPE_API_KEY → QWEN_API_KEY (viene usata la prima corrispondenza)
Flag di configurazione iniziale --auth-choice alibaba-model-studio-api-key
Flag CLI diretto --alibaba-model-studio-api-key <key>
Modello predefinito alibaba/wan2.6-t2v
URL di base predefinito https://dashscope-intl.aliyuncs.com

Per iniziare

  • Impostare una chiave API

    Memorizza la chiave per il provider alibaba tramite la configurazione iniziale:

    bash
    openclaw onboard --auth-choice alibaba-model-studio-api-key

    In alternativa, passa direttamente la chiave:

    bash
    openclaw onboard --alibaba-model-studio-api-key <your-key>

    Oppure esporta una delle variabili di ambiente accettate prima di avviare il Gateway:

    bash
    export MODELSTUDIO_API_KEY=sk-...# oppure DASHSCOPE_API_KEY=...# oppure QWEN_API_KEY=...

  • Impostare un modello video predefinito

    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "alibaba/wan2.6-t2v",      },    },  },}

  • Verificare che il provider sia configurato

    bash
    openclaw models list --provider alibaba

    L'elenco include tutti e cinque i modelli Wan inclusi. Se non è possibile risolvere MODELSTUDIO_API_KEY, openclaw models status --json segnala la credenziale mancante in auth.unusableProfiles.

    • Modelli Wan integrati

    Riferimento del modello Modalità
    alibaba/wan2.6-t2v Da testo a video (predefinita)
    alibaba/wan2.6-i2v Da immagine a video
    alibaba/wan2.6-r2v Da riferimento a video
    alibaba/wan2.6-r2v-flash Da riferimento a video (rapida)
    alibaba/wan2.7-r2v Da riferimento a video

    Funzionalità e limiti

    Tutte e tre le modalità condividono lo stesso limite per richiesta relativo al numero e alla durata dei video; cambia solo la struttura dell'input.

    Modalità Numero massimo di video di output Numero massimo di immagini di input Numero massimo di video di input Durata massima Controlli supportati
    Da testo a video 1 non applicabile non applicabile 10 s size, aspectRatio, resolution, audio, watermark
    Da immagine a video 1 1 non applicabile 10 s size, aspectRatio, resolution, audio, watermark
    Da riferimento a video 1 non applicabile 4 10 s size, aspectRatio, resolution, audio, watermark

    Una richiesta che omette durationSeconds usa il valore predefinito accettato da DashScope di 5 secondi. Imposta esplicitamente durationSeconds nello strumento di generazione video per estendere la durata fino a 10 s.

    Configurazione avanzata

    Sostituire l'URL di base di DashScope

    Per impostazione predefinita, il provider usa l'endpoint internazionale di DashScope. Per usare l'endpoint della regione cinese:

    json5
    {  models: {    providers: {      alibaba: {        baseUrl: "https://dashscope.aliyuncs.com",      },    },  },}

    Il provider rimuove le barre finali prima di costruire gli URL delle attività AIGC.

    Priorità delle variabili di ambiente per l'autenticazione

    OpenClaw risolve la chiave API di Alibaba dalle variabili di ambiente nell'ordine seguente, usando il primo valore non vuoto:

    1. MODELSTUDIO_API_KEY
    2. DASHSCOPE_API_KEY
    3. QWEN_API_KEY

    Le voci auth.profiles configurate (impostate tramite openclaw models auth login) hanno la precedenza sulla risoluzione delle variabili di ambiente. Consulta Profili di autenticazione nelle domande frequenti sui modelli per informazioni sulla rotazione dei profili, sui periodi di attesa e sui meccanismi di sostituzione.

    Relazione con il plugin Qwen

    Entrambi i plugin inclusi comunicano con DashScope e accettano chiavi API sovrapposte. Usa:

    • Gli ID alibaba/wan*.* per il provider video Wan dedicato documentato in questa pagina.
    • Gli ID qwen/* per la chat, gli embedding e la comprensione multimediale di Qwen (consulta Qwen).

    Impostando MODELSTUDIO_API_KEY una sola volta si autenticano entrambi i plugin, poiché gli elenchi delle variabili di ambiente per l'autenticazione si sovrappongono intenzionalmente; non è necessario eseguire separatamente la configurazione iniziale di ciascun plugin.

    Argomenti correlati

    Generazione video

    Parametri condivisi dello strumento video e selezione del provider.
    Qwen

    Configurazione della chat, degli embedding e della comprensione multimediale di Qwen con la stessa autenticazione DashScope.
    Riferimento per la configurazione

    Valori predefiniti degli agenti e configurazione dei modelli.
    Domande frequenti sui modelli

    Profili di autenticazione, cambio di modello e risoluzione degli errori "nessun profilo".
    Was this useful?
    On this page

    On this page