Langsung ke konten utama
OpenClaw menyertakan provider fal bawaan untuk pembuatan gambar, video, dan musik yang dihosting.
PropertiNilai
Providerfal
AuthFAL_KEY (kanonis; FAL_API_KEY juga berfungsi sebagai fallback)
APIendpoint model fal

​
Memulai

1

Tetapkan kunci API

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

Tetapkan model gambar default

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

​
Pembuatan gambar

Provider pembuatan gambar fal bawaan menggunakan default fal/fal-ai/flux/dev.
KapabilitasNilai
Gambar maks4 per permintaan; Krea 2: 1 per permintaan
Mode editFlux: 1 gambar referensi; GPT Image 2: 10; Nano Banana 2: 14
Referensi gayaKrea 2: hingga 10 referensi gaya melalui image / images
Override ukuranDidukung
Rasio aspekDidukung untuk generate, Krea 2, dan edit GPT Image 2/Nano Banana 2
ResolusiDidukung
Format outputpng atau jpeg
Permintaan image-to-image Flux tidak mendukung override aspectRatio. Permintaan edit GPT Image 2 dan Nano Banana 2 menggunakan endpoint /edit fal dan menerima petunjuk rasio aspek. Nano Banana 2 juga menerima rasio lebar/tinggi ekstra-native seperti 4:1, 1:4, 8:1, dan 1:8; Krea 2 memvalidasi subset rasio aspeknya sendiri yang lebih kecil.
Model Krea 2 menggunakan skema payload Krea native milik fal. OpenClaw mengirim aspect_ratio, creativity, dan image_style_references, bukan payload generik image_size / endpoint edit yang digunakan oleh Flux. Ref modelnya adalah:
  • fal/krea/v2/medium/text-to-image
  • fal/krea/v2/large/text-to-image
Gunakan Medium untuk ilustrasi ekspresif, anime, lukisan, dan gaya artistik yang lebih cepat. Gunakan Large untuk tampilan fotorealistis, tekstur mentah, grain film, dan detail yang lebih lambat. Default Krea adalah fal.creativity: "medium"; nilai yang didukung adalah raw, low, medium, dan high. Krea 2 mengekspos rasio aspek, bukan image_size, dalam skema permintaan fal. Utamakan aspectRatio; OpenClaw memetakan size ke rasio aspek Krea terdekat yang didukung dan menolak resolution untuk Krea alih-alih mengabaikannya. Gunakan outputFormat: "png" saat Anda menginginkan output PNG dari model fal yang mengekspos output_format. fal tidak mendeklarasikan kontrol latar belakang transparan eksplisit di OpenClaw, jadi background: "transparent" dilaporkan sebagai override yang diabaikan untuk model fal. Endpoint Krea 2 tidak mengekspos field permintaan output_format melalui fal, jadi OpenClaw menolak override outputFormat untuk permintaan Krea. Untuk menggunakan fal sebagai provider gambar default: 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/fal-ai/flux/dev",
      },
    },
  },
}
Untuk menggunakan Krea 2 Medium: 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/krea/v2/medium/text-to-image",
      },
    },
  },
}

​
Pembuatan video

Provider pembuatan video fal bawaan menggunakan default fal/fal-ai/minimax/video-01-live.
KapabilitasNilai
ModeText-to-video, referensi satu gambar, Seedance reference-to-video
RuntimeAlur submit/status/result berbasis antrean untuk pekerjaan berjalan lama
Agen video HeyGen:
  • 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",
      },
    },
  },
}
Reference-to-video menerima hingga 9 gambar, 3 video, dan 3 referensi audio melalui parameter bersama video_generate images, videos, dan audioRefs, dengan total maksimal 12 file referensi.
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/fal-ai/heygen/v2/video-agent",
      },
    },
  },
}

​
Pembuatan musik

Plugin fal bawaan juga mendaftarkan provider pembuatan musik untuk tool bersama music_generate.
KapabilitasNilai
Model defaultfal/fal-ai/minimax-music/v2.6
Modelfal-ai/minimax-music/v2.6, fal-ai/ace-step/prompt-to-audio, fal-ai/stable-audio-25/text-to-audio
RuntimePermintaan sinkron ditambah unduhan audio yang dihasilkan
Gunakan fal sebagai provider musik default: 
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "fal/fal-ai/minimax-music/v2.6",
      },
    },
  },
}
fal-ai/minimax-music/v2.6 mendukung lirik eksplisit dan mode instrumental. ACE-Step dan Stable Audio adalah endpoint prompt-to-audio; pilih keduanya dengan override model saat Anda menginginkan keluarga model tersebut.
Gunakan openclaw models list --provider fal untuk melihat daftar lengkap model fal yang tersedia, termasuk entri yang baru ditambahkan.

​
Terkait

Pembuatan gambar

Parameter tool gambar bersama dan pemilihan provider.

Pembuatan video

Parameter tool video bersama dan pemilihan provider.

Pembuatan musik

Parameter tool musik bersama dan pemilihan provider.

Referensi konfigurasi

Default agen termasuk pemilihan model gambar, video, dan musik.