Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 自带一个 fal 提供程序，用于托管图像和视频生成。
PropertyValue
Providerfal
AuthFAL_KEY（规范；FAL_API_KEY 也可作为回退使用）
APIfal 模型端点

​
开始使用

1

设置 API 密钥

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

设置默认图像模型

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

​
图像生成

内置的 fal 图像生成提供程序默认使用 fal/fal-ai/flux/dev。
CapabilityValue
Max images每个请求最多 4 张
Edit mode已启用，1 张参考图像
Size overrides支持
Aspect ratio支持
Resolution支持
Output formatpng 或 jpeg
fal 图像编辑端点不支持 aspectRatio 覆盖。
当您想要 PNG 输出时，请使用 outputFormat: "png"。fal 在 OpenClaw 中没有声明 明确的透明背景控制，因此 background: "transparent" 会被标记为对 fal 模型已忽略的覆盖项。 要将 fal 设为默认图像提供程序： 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/fal-ai/flux/dev",
      },
    },
  },
}

​
视频生成

内置的 fal 视频生成提供程序默认使用 fal/fal-ai/minimax/video-01-live。
CapabilityValue
Modes文本生成视频、单图参考、Seedance 参考生成视频
Runtime面向长时间运行任务的基于队列的提交/状态/结果流程
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",
      },
    },
  },
}
参考生成视频最多接受 9 张图像、3 个视频和 3 个音频参考， 通过共享的 video_generate images、videos 和 audioRefs 参数传入，总参考文件数最多 12 个。
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/fal-ai/heygen/v2/video-agent",
      },
    },
  },
}
使用 openclaw models list --provider fal 查看可用 fal 模型的完整列表，包括最近新增的条目。

​
相关内容

图像生成

共享的图像工具参数和提供程序选择。

视频生成

共享的视频工具参数和提供程序选择。

配置参考

代理默认值，包括图像和视频模型选择。