openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh zh-CN translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-05 23:14:40 +00:00
parent c44ce074c7
commit 37aa0da9de
2 changed files with 54 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
docs/zh-CN/providers/fal.md
View File

@ -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 用作默认视频提供商：

85
docs/zh-CN/tools/video-generation.md
View File

@ -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` 工具让智能体使用你已配置的提供商创建视频。生成的视频会作为媒体附件自动随智能体的回复一起发送。
<Note>
只有在至少有一个视频生成提供商可用时，此工具才会显示。如果你在智能体的工具中看不到 `video_generate`，请配置 `agents.defaults.videoGenerationModel` 或设置提供商 API 密钥。
只有在至少有一个视频生成提供商可用时，此工具才会显示。如果你在智能体工具中看不到 `video_generate`，请配置 `agents.defaults.videoGenerationModel` 或设置提供商 API 密钥。
</Note>
<Note>
OpenClaw 现在会在智能体具有会话键时，将 `video_generate` 的运行记录到任务账本中，因此即使该工具在当前轮次中仍会等待完成，你也可以使用任务 / 运行 ID 跟踪长时间运行的生成任务。
</Note>
## 快速开始
@ -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) —— 模型配置与故障切换