diff --git a/docs/zh-CN/providers/fal.md b/docs/zh-CN/providers/fal.md
index 022d95ff5..04be9d655 100644
--- a/docs/zh-CN/providers/fal.md
+++ b/docs/zh-CN/providers/fal.md
@@ -1,25 +1,25 @@
---
read_when:
- 你想在 OpenClaw 中使用 fal 图像生成
- - 你需要 FAL_KEY 认证流程
- - 你想为 image_generate 或 video_generate 使用 fal 默认值
-summary: 在 OpenClaw 中设置 fal 图像和视频生成
+ - 你需要 `FAL_KEY` 认证流程
+ - 你想为 `image_generate` 或 `video_generate` 使用 fal 默认值
+summary: OpenClaw 中的 fal 图像和视频生成设置
title: fal
x-i18n:
- generated_at: "2026-04-05T22:22:53Z"
+ generated_at: "2026-04-05T23:14:26Z"
model: gpt-5.4
provider: openai
- source_hash: f136abdc36826812c9f1930483df308247de07be2dacab4d4c6c1b32d951602c
+ source_hash: 1922907d2c8360c5877a56495323d54bd846d47c27a801155e3d11e3f5706fbd
source_path: providers/fal.md
workflow: 15
---
# fal
-OpenClaw 内置了一个 `fal` 提供商，用于托管式图像和视频生成。
+OpenClaw 内置了 `fal` 提供商，用于托管式图像和视频生成。
- 提供商：`fal`
-- 认证：`FAL_KEY`
+- 认证：`FAL_KEY`（规范方式；`FAL_API_KEY` 也可作为回退方案）
- API：fal 模型端点
## 快速开始
@@ -52,7 +52,7 @@ openclaw onboard --auth-choice fal-api-key
- 生成：每个请求最多 4 张图像
- 编辑模式：已启用，支持 1 张参考图像
- 支持 `size`、`aspectRatio` 和 `resolution`
-- 当前编辑限制：fal 图像编辑端点**不**支持
+- 当前编辑注意事项：fal 图像编辑端点**不**支持
`aspectRatio` 覆盖
要将 fal 用作默认图像提供商：
@@ -75,6 +75,7 @@ openclaw onboard --auth-choice fal-api-key
`fal/fal-ai/minimax/video-01-live`。
- 模式：文生视频和单图参考流程
+- 运行时：基于队列的提交 / 状态 / 结果流程，用于长时间运行的任务
要将 fal 用作默认视频提供商：
diff --git a/docs/zh-CN/tools/video-generation.md b/docs/zh-CN/tools/video-generation.md
index 7b07f2cb0..e06048689 100644
--- a/docs/zh-CN/tools/video-generation.md
+++ b/docs/zh-CN/tools/video-generation.md
@@ -3,23 +3,27 @@ read_when:
- 通过智能体生成视频
- 配置视频生成提供商和模型
- 了解 `video_generate` 工具参数
-summary: 使用已配置的提供商（例如 Alibaba、OpenAI、Google、Qwen 和 MiniMax）生成视频
+summary: 使用已配置的提供商（如 Alibaba、OpenAI、Google、Qwen 和 MiniMax）生成视频
title: 视频生成
x-i18n:
- generated_at: "2026-04-05T22:59:35Z"
+ generated_at: "2026-04-05T23:14:40Z"
model: gpt-5.4
provider: openai
- source_hash: 8b57870c6a53e51694cc1606b5620fc7b260a64ff9aec83a6123566f64b6f2ab
+ source_hash: 992068bc687982044023920557d9a839540175f62ac83e26b579c420c2a010fd
source_path: tools/video-generation.md
workflow: 15
---
# 视频生成
-`video_generate` 工具让智能体能够使用你已配置的提供商创建视频。生成的视频会作为媒体附件自动随智能体的回复一并发送。
+`video_generate` 工具让智能体使用你已配置的提供商创建视频。生成的视频会作为媒体附件自动随智能体的回复一起发送。
-只有在至少有一个视频生成提供商可用时，此工具才会显示。如果你在智能体的工具中看不到 `video_generate`，请配置 `agents.defaults.videoGenerationModel` 或设置提供商 API 密钥。
+只有在至少有一个视频生成提供商可用时，此工具才会显示。如果你在智能体工具中看不到 `video_generate`，请配置 `agents.defaults.videoGenerationModel` 或设置提供商 API 密钥。
+
+
+
+OpenClaw 现在会在智能体具有会话键时，将 `video_generate` 的运行记录到任务账本中，因此即使该工具在当前轮次中仍会等待完成，你也可以使用任务 / 运行 ID 跟踪长时间运行的生成任务。
## 快速开始
@@ -39,9 +43,9 @@ x-i18n:
}
```
-3. 向智能体提出请求：_“生成一段 5 秒钟、具有电影感的友好龙虾在日落时分冲浪的视频。”_
+3. 向智能体提问：_“生成一个 5 秒钟的电影感视频，内容是一只友善的龙虾在日落时分冲浪。”_
-智能体会自动调用 `video_generate`。不需要工具允许列表 —— 当有可用提供商时，它默认启用。
+智能体会自动调用 `video_generate`。无需配置工具允许列表 —— 当提供商可用时，它默认启用。
## 支持的提供商
@@ -50,12 +54,12 @@ x-i18n:
| Alibaba | `wan2.6-t2v` | 是，远程 URL | `MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY`, `QWEN_API_KEY` |
| BytePlus（国际版） | `seedance-1-0-lite-t2v-250428` | 1 张图片 | `BYTEPLUS_API_KEY` |
| fal | `fal-ai/minimax/video-01-live` | 1 张图片 | `FAL_KEY` |
-| Google | `veo-3.1-fast-generate-preview` | 1 张图片或 1 个视频 | `GEMINI_API_KEY`, `GOOGLE_API_KEY` |
-| MiniMax | `MiniMax-Hailuo-2.3` | 1 张图片 | `MINIMAX_API_KEY` |
-| OpenAI | `sora-2` | 1 张图片或 1 个视频 | `OPENAI_API_KEY` |
-| Qwen | `wan2.6-t2v` | 是，远程 URL | `QWEN_API_KEY`, `MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY` |
+| Google | `veo-3.1-fast-generate-preview` | 1 张图片或 1 个视频 | `GEMINI_API_KEY`, `GOOGLE_API_KEY` |
+| MiniMax | `MiniMax-Hailuo-2.3` | 1 张图片 | `MINIMAX_API_KEY` |
+| OpenAI | `sora-2` | 1 张图片或 1 个视频 | `OPENAI_API_KEY` |
+| Qwen | `wan2.6-t2v` | 是，远程 URL | `QWEN_API_KEY`, `MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY` |
| Together | `Wan-AI/Wan2.2-T2V-A14B` | 1 张图片 | `TOGETHER_API_KEY` |
-| xAI | `grok-imagine-video` | 1 张图片或 1 个视频 | `XAI_API_KEY` |
+| xAI | `grok-imagine-video` | 1 张图片或 1 个视频 | `XAI_API_KEY` |
使用 `action: "list"` 可在运行时查看可用的提供商和模型：
@@ -65,24 +69,24 @@ x-i18n:
## 工具参数
-| 参数 | 类型 | 说明 |
+| 参数 | 类型 | 描述 |
| ----------------- | -------- | -------------------------------------------------------------------------------------- |
| `prompt` | string | 视频生成提示词（`action: "generate"` 时必填） |
| `action` | string | `"generate"`（默认）或 `"list"`，用于查看提供商 |
-| `model` | string | 提供商/模型覆盖，例如 `qwen/wan2.6-t2v` |
-| `image` | string | 单个参考图片路径或 URL |
-| `images` | string[] | 多个参考图片（最多 5 张） |
-| `video` | string | 单个参考视频路径或 URL |
-| `videos` | string[] | 多个参考视频（最多 4 个） |
-| `size` | string | 当提供商支持时使用的尺寸提示 |
-| `aspectRatio` | string | 宽高比：`1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9` |
-| `resolution` | string | 分辨率提示：`480P`、`720P` 或 `1080P` |
-| `durationSeconds` | number | 目标时长（秒）。OpenClaw 可能会将其四舍五入到最接近的提供商支持值 |
-| `audio` | boolean | 当提供商支持时启用生成音频 |
-| `watermark` | boolean | 当支持时切换提供商水印 |
-| `filename` | string | 输出文件名提示 |
+| `model` | string | 提供商 / 模型覆盖，例如 `qwen/wan2.6-t2v` |
+| `image` | string | 单个参考图片路径或 URL |
+| `images` | string[] | 多个参考图片（最多 5 张） |
+| `video` | string | 单个参考视频路径或 URL |
+| `videos` | string[] | 多个参考视频（最多 4 个） |
+| `size` | string | 当提供商支持时的尺寸提示 |
+| `aspectRatio` | string | 宽高比：`1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9` |
+| `resolution` | string | 分辨率提示：`480P`、`720P` 或 `1080P` |
+| `durationSeconds` | number | 目标时长（秒）。OpenClaw 可能会将其四舍五入到提供商支持的最近值 |
+| `audio` | boolean | 当提供商支持时启用生成音频 |
+| `watermark` | boolean | 当支持时切换提供商水印 |
+| `filename` | string | 输出文件名提示 |
-并非所有提供商都支持所有参数。该工具会在提交请求前验证提供商的能力限制。当某个提供商或模型只支持离散的视频时长集合时，OpenClaw 会将 `durationSeconds` 四舍五入到最接近的受支持值，并在工具结果中报告规范化后的时长。
+并非所有提供商都支持全部参数。该工具会在提交请求前校验提供商能力限制。当某个提供商或模型只支持离散的视频时长集合时，OpenClaw 会将 `durationSeconds` 调整为最近的受支持值，并在工具结果中报告标准化后的时长。
## 配置
@@ -105,37 +109,38 @@ x-i18n:
生成视频时，OpenClaw 会按以下顺序尝试提供商：
-1. 工具调用中的 **`model` 参数**（如果智能体指定了一个）
+1. 工具调用中的 **`model` 参数**（如果智能体指定了）
2. 配置中的 **`videoGenerationModel.primary`**
3. 按顺序使用 **`videoGenerationModel.fallbacks`**
-4. **自动检测** —— 仅使用基于认证的提供商默认值：
- - 先使用当前默认提供商
- - 再按 provider-id 顺序使用其余已注册的视频生成提供商
+4. **自动检测** —— 仅使用有凭证支持的提供商默认值：
+ - 先尝试当前默认提供商
+ - 再按提供商 ID 顺序尝试其余已注册的视频生成提供商
-如果某个提供商失败，会自动尝试下一个候选项。如果全部失败，错误信息中会包含每次尝试的详细信息。
+如果某个提供商失败，会自动尝试下一个候选项。如果全部失败，错误信息会包含每次尝试的详细信息。
## 提供商说明
-- Alibaba 使用 DashScope / Model Studio 异步视频端点，目前要求参考资源使用远程 `http(s)` URL。
-- Google 使用 Gemini/Veo，并支持单个图片或视频参考输入。
-- MiniMax、Together、BytePlus（国际版）和 fal 目前支持单个图片参考输入。
+- Alibaba 使用 DashScope / Model Studio 异步视频端点，目前参考素材必须使用远程 `http(s)` URL。
+- Google 使用 Gemini / Veo，并支持单张图片或单个视频作为参考输入。
+- MiniMax、Together、BytePlus（国际版）和 fal 目前支持单张图片作为参考输入。
- OpenAI 使用原生视频端点，目前默认使用 `sora-2`。
-- Qwen 支持图片/视频参考，但上游 DashScope 视频端点目前要求这些参考必须是远程 `http(s)` URL。
-- xAI 使用原生 xAI 视频 API，并支持文生视频、图生视频，以及远程视频编辑/扩展流程。
+- Qwen 支持图片 / 视频参考，但上游 DashScope 视频端点目前要求这些参考必须是远程 `http(s)` URL。
+- xAI 使用原生 xAI 视频 API，支持文生视频、图生视频，以及远程视频编辑 / 延展流程。
+- fal 对于长时间运行的任务，使用基于队列的 fal 视频流程，而不是单个阻塞式推理请求。
## Qwen 参考输入
-内置的 Qwen 提供商支持文生视频以及图片/视频参考模式，但上游 DashScope 视频端点目前要求参考输入必须为 **远程 http(s) URL**。本地文件路径和上传的缓冲区会被提前拒绝，而不是被静默忽略。
+内置的 Qwen 提供商支持文生视频以及图片 / 视频参考模式，但上游 DashScope 视频端点目前要求参考输入必须为**远程 http(s) URL**。本地文件路径和上传的缓冲区会在前置检查时直接被拒绝，而不会被静默忽略。
## 相关内容
- [工具概览](/zh-CN/tools) —— 所有可用的智能体工具
-- [Alibaba Model Studio](/zh-CN/providers/alibaba) —— 直接设置 Wan 提供商
+- [Alibaba Model Studio](/zh-CN/providers/alibaba) —— 直接配置 Wan 提供商
- [Google（Gemini）](/zh-CN/providers/google) —— Veo 提供商设置
- [MiniMax](/zh-CN/providers/minimax) —— Hailuo 提供商设置
- [OpenAI](/zh-CN/providers/openai) —— Sora 提供商设置
-- [Qwen](/zh-CN/providers/qwen) —— Qwen 专用设置和限制
+- [Qwen](/zh-CN/providers/qwen) —— Qwen 专属设置与限制
- [Together AI](/zh-CN/providers/together) —— Together Wan 提供商设置
- [xAI](/zh-CN/providers/xai) —— Grok 视频提供商设置
- [配置参考](/zh-CN/gateway/configuration-reference#agent-defaults) —— `videoGenerationModel` 配置
-- [模型](/zh-CN/concepts/models) —— 模型配置和故障转移
+- [模型](/zh-CN/concepts/models) —— 模型配置与故障切换