session:

1. OpenClaw submits the request to the provider and immediately returns a task id.

2. The provider processes the job in the background (typically 30 seconds to 5 minutes depending on the provider and resolution).

2. The provider processes the job in the background (typically 30 seconds to several minutes depending on the provider and resolution; slow queue-backed providers can run up to the configured timeout).

3. When the video is ready, OpenClaw wakes the same session with an internal completion event.

4. The agent tells the user and attaches the finished video. In group/channel

chats that use message-tool-only visible delivery, the agent relays the

### Task lifecycle

| State | Meaning |

| ----------- | ------------------------------------------------------------------------------------------------ |

| `queued` | Task created, waiting for the provider to accept it. |

| `running` | Provider is processing (typically 30 seconds to 5 minutes depending on provider and resolution). |

| `succeeded` | Video ready; the agent wakes and posts it to the conversation. |

| `failed` | Provider error or timeout; the agent wakes with error details. |

| State | Meaning |

| ----------- | ------------------------------------------------------------------------------------------------------ |

| `queued` | Task created, waiting for the provider to accept it. |

| `running` | Provider is processing (typically 30 seconds to several minutes depending on provider and resolution). |

| `succeeded` | Video ready; the agent wakes and posts it to the conversation. |

| `failed` | Provider error or timeout; the agent wakes with error details. |

Check status from the CLI:

</ParamField>

<ParamField path="model" type="string">Provider/model override (e.g. `runway/gen4.5`).</ParamField>

<ParamField path="filename" type="string">Output filename hint.</ParamField>

<ParamField path="timeoutMs" type="number">Optional provider request timeout in milliseconds.</ParamField>

<ParamField path="timeoutMs" type="number">Optional provider operation timeout in milliseconds.</ParamField>

<ParamField path="providerOptions" type="object">

Provider-specific options as a JSON object (e.g. `{"seed": 42, "draft": true}`).

Providers that declare a typed schema validate the keys and types; unknown

image-to-video through the configured graph.

</Accordion>

<Accordion title="fal">

Uses a queue-backed flow for long-running jobs. Most fal video models

Uses a queue-backed flow for long-running jobs. OpenClaw waits up to 20

minutes by default before treating an in-progress fal queue job as timed

out. Most fal video models

accept a single image reference. Seedance 2.0 reference-to-video

models accept up to 9 images, 3 videos, and 3 audio references, with

at most 12 total reference files.

</Accordion>

<Accordion title="Google (Gemini / Veo)">

Supports one image or one video reference.

Supports one image or one video reference. Generated-audio requests are

ignored with a warning on the Gemini API path because that API rejects

the `generateAudio` parameter for current Veo video generation.

</Accordion>

<Accordion title="MiniMax">

Single image reference only.

Single image reference only. MiniMax accepts `768P` and `1080P`

resolutions; requests such as `720P` are normalized to the closest

supported value before submission.

</Accordion>

<Accordion title="OpenAI">

Only `size` override is forwarded. Other style overrides