hansjone/oclaw
1
0
Fork 0
mirror of https://github.com/hansjone/oclaw.git synced 2026-10-10 05:10:45 +08:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
oclaw/openclaw/docs/providers/fal.md
oliver dbbe3add6a 重构主控编排与运行时预热链路，统一工作区提示词/专家调度协议并补齐 wiki 记忆注入与写回闭环。 
同时收敛启动与运维脚本默认行为（含 wiki worker）、更新 Admin 可观测性与相关测试，降低首轮时延并提高运行稳定性。

Made-with: Cursor
2026-04-26 08:34:33 +08:00

3.7 KiB
Raw Blame History

title summary read_when
fal fal image and video generation setup in OpenClaw
You want to use fal image generation in OpenClaw
You need the FAL_KEY auth flow
You want fal defaults for image_generate or video_generate

fal

OpenClaw ships a bundled fal provider for hosted image and video generation.

Property Value
Provider fal
Auth FAL_KEY (canonical; FAL_API_KEY also works as a fallback)
API fal model endpoints

Getting started

```bash openclaw onboard --auth-choice fal-api-key ``` ```json5 { agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, }, } ```

Image generation

The bundled fal image-generation provider defaults to fal/fal-ai/flux/dev.

Capability Value
Max images 4 per request
Edit mode Enabled, 1 reference image
Size overrides Supported
Aspect ratio Supported
Resolution Supported
The fal image edit endpoint does **not** support `aspectRatio` overrides.

To use fal as the default image provider:

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

Video generation

The bundled fal video-generation provider defaults to fal/fal-ai/minimax/video-01-live.

Capability Value
Modes Text-to-video, single-image reference
Runtime Queue-backed submit/status/result flow for long-running jobs
**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/text-to-video`
- `fal/bytedance/seedance-2.0/image-to-video`
```json5 { agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, }, } ``` ```json5 { agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, }, } ``` Use `openclaw models list --provider fal` to see the full list of available fal models, including any recently added entries.

Related

Shared image tool parameters and provider selection. Shared video tool parameters and provider selection. Agent defaults including image and video model selection.