Vai al contenuto principale
OpenClaw include un provider fal integrato per la generazione ospitata di immagini, video e musica.
ProprietàValore
Providerfal
AutenticazioneFAL_KEY (canonico; FAL_API_KEY funziona anche come fallback)
APIendpoint dei modelli fal

​
Per iniziare

1

Imposta la chiave API

openclaw onboard --auth-choice fal-api-key
2

Imposta un modello immagine predefinito

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/fal-ai/flux/dev",
      },
    },
  },
}

​
Generazione di immagini

Il provider integrato fal per la generazione di immagini usa come valore predefinito fal/fal-ai/flux/dev.
FunzionalitàValore
Immagini massime4 per richiesta; Krea 2: 1 per richiesta
Modalità modificaFlux: 1 immagine di riferimento; GPT Image 2: 10; Nano Banana 2: 14
Rif. di stileKrea 2: fino a 10 riferimenti di stile tramite image / images
Override dimensioneSupportati
ProporzioniSupportate per generazione, Krea 2 e modifica GPT Image 2/Nano Banana 2
RisoluzioneSupportata
Formato di outputpng o jpeg
Le richieste Flux da immagine a immagine non supportano override di aspectRatio. Le richieste di modifica GPT Image 2 e Nano Banana 2 usano l’endpoint /edit di fal e accettano suggerimenti sulle proporzioni. Nano Banana 2 accetta anche rapporti larghi/alti extra nativi come 4:1, 1:4, 8:1 e 1:8; Krea 2 convalida il proprio sottoinsieme più ristretto di proporzioni.
I modelli Krea 2 usano lo schema di payload Krea nativo di fal. OpenClaw invia aspect_ratio, creativity e image_style_references invece del payload generico image_size / endpoint di modifica usato da Flux. I riferimenti dei modelli sono:
  • fal/krea/v2/medium/text-to-image
  • fal/krea/v2/large/text-to-image
Usa Medium per illustrazioni espressive, anime, pittura e stili artistici più rapidi. Usa Large per risultati fotorealistici più lenti, texture grezze, grana cinematografica e aspetti dettagliati. Krea usa come predefinito fal.creativity: "medium"; i valori supportati sono raw, low, medium e high. Krea 2 espone le proporzioni, non image_size, nello schema di richiesta di fal. Preferisci aspectRatio; OpenClaw mappa size alle proporzioni Krea supportate più vicine e rifiuta resolution per Krea invece di ignorarla. Usa outputFormat: "png" quando vuoi output PNG dai modelli fal che espongono output_format. fal non dichiara in OpenClaw un controllo esplicito dello sfondo trasparente, quindi background: "transparent" viene segnalato come override ignorato per i modelli fal. Gli endpoint Krea 2 non espongono un campo di richiesta output_format tramite fal, quindi OpenClaw rifiuta gli override outputFormat per le richieste Krea. Per usare fal come provider immagine predefinito: 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/fal-ai/flux/dev",
      },
    },
  },
}
Per usare Krea 2 Medium: 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/krea/v2/medium/text-to-image",
      },
    },
  },
}

​
Generazione di video

Il provider integrato fal per la generazione di video usa come valore predefinito fal/fal-ai/minimax/video-01-live.
FunzionalitàValore
ModalitàDa testo a video, riferimento a immagine singola, Seedance da riferimento a video
RuntimeFlusso invio/stato/risultato basato su coda per job a lunga esecuzione
HeyGen video-agent:
  • fal/fal-ai/heygen/v2/video-agent
Seedance 2.0:
  • fal/bytedance/seedance-2.0/fast/text-to-video
  • fal/bytedance/seedance-2.0/fast/image-to-video
  • fal/bytedance/seedance-2.0/fast/reference-to-video
  • fal/bytedance/seedance-2.0/text-to-video
  • fal/bytedance/seedance-2.0/image-to-video
  • fal/bytedance/seedance-2.0/reference-to-video
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
      },
    },
  },
}

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
      },
    },
  },
}
Da riferimento a video accetta fino a 9 immagini, 3 video e 3 riferimenti audio tramite i parametri condivisi video_generate images, videos e audioRefs, con al massimo 12 file di riferimento totali.
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/fal-ai/heygen/v2/video-agent",
      },
    },
  },
}

​
Generazione di musica

Il Plugin integrato fal registra anche un provider di generazione musicale per lo strumento condiviso music_generate.
FunzionalitàValore
Modello predefinitofal/fal-ai/minimax-music/v2.6
Modellifal-ai/minimax-music/v2.6, fal-ai/ace-step/prompt-to-audio, fal-ai/stable-audio-25/text-to-audio
RuntimeRichiesta sincrona più download dell’audio generato
Usa fal come provider musicale predefinito: 
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "fal/fal-ai/minimax-music/v2.6",
      },
    },
  },
}
fal-ai/minimax-music/v2.6 supporta testi espliciti e modalità strumentale. ACE-Step e Stable Audio sono endpoint da prompt ad audio; sceglili con l’override model quando vuoi quelle famiglie di modelli.
Usa openclaw models list --provider fal per vedere l’elenco completo dei modelli fal disponibili, incluse eventuali voci aggiunte di recente.

​
Correlati

Generazione di immagini

Parametri condivisi dello strumento immagine e selezione del provider.

Generazione di video

Parametri condivisi dello strumento video e selezione del provider.

Generazione di musica

Parametri condivisi dello strumento musica e selezione del provider.

Riferimento di configurazione

Valori predefiniti degli agenti, inclusa la selezione dei modelli di immagini, video e musica.