Providers

Alibaba Model Studio

OpenClaw include un plugin alibaba in bundle che registra un provider per la generazione video per i modelli Wan su Alibaba Model Studio (il nome internazionale di DashScope). Il plugin è abilitato per impostazione predefinita; devi solo impostare una chiave API.

Proprietà Valore
ID provider alibaba
Plugin in bundle, enabledByDefault: true
Variabili env auth MODELSTUDIO_API_KEYDASHSCOPE_API_KEYQWEN_API_KEY (vince la prima corrispondenza)
Flag onboarding --auth-choice alibaba-model-studio-api-key
Flag CLI diretto --alibaba-model-studio-api-key <key>
Modello predefinito alibaba/wan2.6-t2v
URL base predefinito https://dashscope-intl.aliyuncs.com

Per iniziare

  • Imposta una chiave API

    Usa l'onboarding per archiviare la chiave per il provider alibaba:

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

    Oppure passa la chiave direttamente durante l'installazione/onboarding:

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

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

    export MODELSTUDIO_API_KEY=sk-...
    # or DASHSCOPE_API_KEY=...
    # or QWEN_API_KEY=...
    
  • Imposta un modello video predefinito

    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "alibaba/wan2.6-t2v",
          },
        },
      },
    }
    
  • Verifica che il provider sia configurato

    openclaw models list --provider alibaba
    

    L'elenco dovrebbe includere tutti e cinque i modelli Wan inclusi in bundle. Se MODELSTUDIO_API_KEY non viene risolta, openclaw models status --json segnala la credenziale mancante in auth.unusableProfiles.

  • Modelli Wan integrati

    Riferimento modello Modalità
    alibaba/wan2.6-t2v Testo-video (predefinito)
    alibaba/wan2.6-i2v Immagine-video
    alibaba/wan2.6-r2v Riferimento-video
    alibaba/wan2.6-r2v-flash Riferimento-video (rapido)
    alibaba/wan2.7-r2v Riferimento-video

    Capacità e limiti

    Il provider incluso in bundle rispecchia i limiti dell'API video Wan di DashScope. Tutte e tre le modalità condividono lo stesso conteggio video per richiesta e lo stesso limite di durata; cambia solo la forma dell'input.

    Modalità Video di output max Immagini di input max Video di input max Durata max Controlli supportati
    Testo-video 1 n/a n/a 10 s size, aspectRatio, resolution, audio, watermark
    Immagine-video 1 1 n/a 10 s size, aspectRatio, resolution, audio, watermark
    Riferimento-video 1 n/a 4 10 s size, aspectRatio, resolution, audio, watermark

    Quando una richiesta omette durationSeconds, il provider invia il valore predefinito accettato da DashScope di 5 secondi. Imposta esplicitamente durationSeconds nello strumento di generazione video per arrivare fino a 10 s.

    Configurazione avanzata

    Sovrascrivi l'URL base di DashScope

    Il provider usa per impostazione predefinita l'endpoint internazionale di DashScope. Per indirizzare l'endpoint della regione Cina, imposta:

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

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

    Priorità env auth

    OpenClaw risolve la chiave API Alibaba dalle variabili di ambiente in quest'ordine, prendendo 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) sovrascrivono la risoluzione delle variabili env. Consulta Profili auth nelle FAQ sui modelli per la rotazione dei profili, il cooldown e i meccanismi di sovrascrittura.

    Relazione con il plugin Qwen

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

    • gli ID alibaba/wan*.* per utilizzare il provider video Wan dedicato documentato in questa pagina.
    • gli ID qwen/* per chat, embedding e comprensione dei media Qwen (vedi Qwen).

    Impostare una sola volta MODELSTUDIO_API_KEY autentica entrambi i plugin perché l'elenco delle variabili env auth è intenzionalmente sovrapposto; non devi eseguire l'onboarding di ciascun plugin separatamente.

    Correlati