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-24 00:46:40 +00:00
parent 60ad1f52f3
commit 6dfddfeefe
3 changed files with 624 additions and 611 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

981
docs/zh-CN/help/testing.md
View File

File diff suppressed because it is too large Load Diff

89
docs/zh-CN/providers/openrouter.md
View File

@ -1,26 +1,26 @@
---
read_when:
- 你想用一个 API key 访问许多 LLM】【。analysis to=final code omitted due developer?
- 你想用一个 API 密钥访问多个 LLM
- 你想在 OpenClaw 中通过 OpenRouter 运行模型
- 你想使用 OpenRouter 进行图像生成
summary: 使用 OpenRouter 的统一 API 在 OpenClaw 中访问多种模型
title: OpenRouter
x-i18n:
generated_at: "2026-04-23T21:01:34Z"
generated_at: "2026-04-24T00:42:34Z"
model: gpt-5.4
provider: openai
source_hash: 29532ce2b7fa2b4643db155f6fd6ee17fd9d14ddf65d5e78d0970a4db7b7694a
source_hash: 7516910f67a8adfb107d07cadd73c34ddd110422ecb90278025d4d6344937aac
source_path: providers/openrouter.md
workflow: 15
---
OpenRouter 提供了一个**统一 API**，可通过单个
端点和 API key 将请求路由到众多模型。它与 OpenAI 兼容，因此大多数 OpenAI SDK 只需切换 base URL 即可使用。
OpenRouter 提供一个**统一 API**，可通过单个端点和 API 密钥将请求路由到多种模型。它兼容 OpenAI，因此大多数 OpenAI SDK 只需切换基础 URL 即可使用。
## 快速开始
## 入门指南
<Steps>
<Step title="获取你的 API key">
在 [openrouter.ai/keys](https://openrouter.ai/keys) 创建一个 API key。
<Step title="获取你的 API 密钥">
在 [openrouter.ai/keys](https://openrouter.ai/keys) 创建一个 API 密钥。
</Step>
<Step title="运行新手引导">
```bash
@ -28,7 +28,7 @@ OpenRouter 提供了一个**统一 API**，可通过单个
```
</Step>
<Step title="（可选）切换到特定模型">
新手引导默认使用 `openrouter/auto`。你之后可以选择一个具体模型：
新手引导默认使用 `openrouter/auto`。你之后可以改为选择具体模型：
```bash
openclaw models set openrouter/<provider>/<model>
@ -53,67 +53,74 @@ OpenRouter 提供了一个**统一 API**，可通过单个
## 模型引用
<Note>
模型引用遵循 `openrouter/<provider>/<model>` 模式。有关
可用提供商和模型的完整列表，请参阅 [/concepts/model-providers](/zh-CN/concepts/model-providers)。
模型引用遵循 `openrouter/<provider>/<model>` 格式。有关可用提供商和模型的完整列表，请参见 [/concepts/model-providers](/zh-CN/concepts/model-providers)。
</Note>
内置回退示例：
| 模型引用 | 说明 |
| ------------------------------------ | ----------------------------- |
| `openrouter/auto` | OpenRouter 自动路由 |
| `openrouter/moonshotai/kimi-k2.6` | 通过 MoonshotAI 访问 Kimi K2.6 |
| Model ref | 说明 |
| ------------------------------------ | ---------------------------- |
| `openrouter/auto` | OpenRouter 自动路由 |
| `openrouter/moonshotai/kimi-k2.6` | 通过 MoonshotAI 使用 Kimi K2.6 |
| `openrouter/openrouter/healer-alpha` | OpenRouter Healer Alpha 路由 |
| `openrouter/openrouter/hunter-alpha` | OpenRouter Hunter Alpha 路由 |
## 身份验证与请求头
## 图像生成
OpenRouter 在底层使用 Bearer token 携带你的 API key。
OpenRouter 也可作为 `image_generate` 工具的后端。在 `agents.defaults.imageGenerationModel` 下使用 OpenRouter 图像模型：
在真实 OpenRouter 请求（`https://openrouter.ai/api/v1`）上，OpenClaw 还会添加
OpenRouter 文档中定义的应用归因头：
```json5
{
env: { OPENROUTER_API_KEY: "sk-or-..." },
agents: {
defaults: {
imageGenerationModel: {
primary: "openrouter/google/gemini-3.1-flash-image-preview",
},
},
},
}
```
| 请求头 | 值 |
OpenClaw 会将图像请求发送到 OpenRouter 的聊天补全图像 API，并使用 `modalities: ["image", "text"]`。Gemini 图像模型会通过 OpenRouter 的 `image_config` 接收受支持的 `aspectRatio` 和 `resolution` 提示。
## 身份验证和请求头
OpenRouter 在底层使用你的 API 密钥作为 Bearer token。
在真实的 OpenRouter 请求（`https://openrouter.ai/api/v1`）中，OpenClaw 还会添加 OpenRouter 文档中说明的应用归因请求头：
| Header | 值 |
| ------------------------- | --------------------- |
| `HTTP-Referer` | `https://openclaw.ai` |
| `X-OpenRouter-Title` | `OpenClaw` |
| `X-OpenRouter-Categories` | `cli-agent` |
| `HTTP-Referer` | `https://openclaw.ai` |
| `X-OpenRouter-Title` | `OpenClaw` |
| `X-OpenRouter-Categories` | `cli-agent` |
<Warning>
如果你将 OpenRouter 提供商改指向其他代理或 base URL，OpenClaw
将**不会**注入这些 OpenRouter 专用请求头，也不会注入 Anthropic 缓存标记。
如果你将 OpenRouter 提供商重新指向其他代理或基础 URL，OpenClaw **不会**注入这些 OpenRouter 专用请求头或 Anthropic 缓存标记。
</Warning>
## 高级配置
<AccordionGroup>
<Accordion title="Anthropic 缓存标记">
在已验证的 OpenRouter 路由上，Anthropic 模型引用会保留
OpenRouter 专用的 Anthropic `cache_control` 标记。OpenClaw 使用这些标记
以更好地复用 system / developer 提示词块上的提示词缓存。
在经过验证的 OpenRouter 路由上，Anthropic 模型引用会保留 OpenClaw 使用的 OpenRouter 专用 Anthropic `cache_control` 标记，以更好地复用 system/developer prompt 块上的提示词缓存。
</Accordion>
<Accordion title="Thinking / 推理注入">
在受支持的非 `auto` 路由上，OpenClaw 会将所选 thinking 等级映射为
OpenRouter 代理推理负载。对于不支持的模型提示以及
`openrouter/auto`，会跳过该推理注入。
<Accordion title="Thinking / reasoning 注入">
在受支持的非 `auto` 路由上，OpenClaw 会将所选的 thinking 级别映射为 OpenRouter 代理推理负载。不受支持的模型提示以及 `openrouter/auto` 会跳过此类推理注入。
</Accordion>
<Accordion title="仅 OpenAI 的请求整形">
OpenRouter 仍然通过代理风格的 OpenAI 兼容路径运行，因此
原生仅 OpenAI 的请求整形，例如 `serviceTier`、Responses `store`、
OpenAI 推理兼容负载，以及提示词缓存提示，都不会被转发。
OpenRouter 仍通过代理式的 OpenAI 兼容路径运行，因此原生仅 OpenAI 的请求整形功能（例如 `serviceTier`、Responses `store`、OpenAI 推理兼容负载和提示词缓存提示）不会被转发。
</Accordion>
<Accordion title="Gemini 支持的路由">
基于 Gemini 的 OpenRouter 引用仍走代理 Gemini 路径：OpenClaw 会在其中
保留 Gemini thought-signature 清理，但不会启用原生 Gemini
重放验证或 bootstrap 重写。
由 Gemini 支持的 OpenRouter 引用会保留在代理 Gemini 路径上：OpenClaw 会在该路径上保留 Gemini thought-signature 清理，但不会启用原生 Gemini 重放验证或引导重写。
</Accordion>
<Accordion title="提供商路由元数据">
如果你在模型参数下传入 OpenRouter 提供商路由信息，OpenClaw 会在共享流包装器运行之前，
将其转发为 OpenRouter 路由元数据。
如果你在模型参数中传入 OpenRouter 提供商路由信息，OpenClaw 会在共享流包装器运行之前，将其作为 OpenRouter 路由元数据进行转发。
</Accordion>
</AccordionGroup>
@ -124,6 +131,6 @@ OpenRouter 文档中定义的应用归因头：
选择提供商、模型引用和故障转移行为。
</Card>
<Card title="配置参考" href="/zh-CN/gateway/configuration-reference" icon="gear">
智能体、模型和提供商的完整配置参考。
agents、models 和 providers 的完整配置参考。
</Card>
</CardGroup>

165
docs/zh-CN/tools/image-generation.md
View File

@ -3,26 +3,26 @@ read_when:
- 通过智能体生成图像
- 配置图像生成提供商和模型
- 了解 `image_generate` 工具参数
summary: 使用已配置的提供商（OpenAI、OpenAI Codex OAuth、Google Gemini、fal、MiniMax、ComfyUI、Vydra、xAI）生成和编辑图像
summary: 使用已配置的提供商（OpenAI、OpenAI Codex OAuth、Google Gemini、OpenRouter、fal、MiniMax、ComfyUI、Vydra、xAI）生成和编辑图像
title: 图像生成
x-i18n:
generated_at: "2026-04-23T23:39:54Z"
generated_at: "2026-04-24T00:42:37Z"
model: gpt-5.4
provider: openai
source_hash: 2ee9f19389824e99d7a2d74f212564e1658b904eb722f09c4a402fcaeabd2487
source_hash: 427df6a3aa2adebef13cb77b6bbc161c010477d8f669b7c20b917382c3acb224
source_path: tools/image-generation.md
workflow: 15
---
`image_generate` 工具让智能体能够使用你已配置的提供商来创建和编辑图像。生成的图像会作为媒体附件自动随智能体的回复一并发送。
`image_generate` 工具允许智能体使用你已配置的提供商创建和编辑图像。生成的图像会作为媒体附件自动包含在智能体的回复中。
<Note>
只有在至少有一个图像生成提供商可用时，此工具才会显示。如果你在智能体的工具中看不到 `image_generate`，请配置 `agents.defaults.imageGenerationModel`、设置提供商 API 密钥，或使用 OpenAI Codex OAuth 登录。
只有在至少有一个图像生成提供商可用时，该工具才会出现。如果你没有在智能体工具中看到 `image_generate`，请配置 `agents.defaults.imageGenerationModel`、设置提供商 API 密钥，或使用 OpenAI Codex OAuth 登录。
</Note>
## 快速开始
1. 为至少一个提供商设置 API 密钥（例如 `OPENAI_API_KEY` 或 `GEMINI_API_KEY`），或使用 OpenAI Codex OAuth 登录。
1. 为至少一个提供商设置 API 密钥（例如 `OPENAI_API_KEY`、`GEMINI_API_KEY` 或 `OPENROUTER_API_KEY`），或使用 OpenAI Codex OAuth 登录。
2. 可选：设置你偏好的模型：
```json5
@ -38,30 +38,31 @@ x-i18n:
```
Codex OAuth 使用相同的 `openai/gpt-image-2` 模型引用。当配置了
`openai-codex` OAuth 配置文件时，OpenClaw 会通过同一个 OAuth 配置文件路由图像请求，而不是先尝试 `OPENAI_API_KEY`。
显式的自定义 `models.providers.openai` 图像配置，例如 API 密钥或
自定义 / Azure 基础 URL，会切换回直接使用 OpenAI Images API 的路由。
对于 LocalAI 这类兼容 OpenAI 的局域网端点，请保留自定义
`openai-codex` OAuth 配置文件时，OpenClaw 会通过该 OAuth 配置文件路由图像请求，而不是先尝试 `OPENAI_API_KEY`。
显式自定义 `models.providers.openai` 图像配置（例如 API 密钥或
自定义 / Azure base URL）会重新切换回直接使用 OpenAI Images API 路由。
对于像 LocalAI 这样的 OpenAI 兼容局域网端点，请保留自定义的
`models.providers.openai.baseUrl`，并显式启用
`browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true`；默认情况下，私有 / 内部图像端点仍会被阻止。
3. 向智能体提问：_“生成一张友好机器人吉祥物的图像。”_
3. 向智能体提问：_“生成一张友好的机器人吉祥物图像。”_
智能体会自动调用 `image_generate`。无需配置工具允许列表——只要有可用的提供商，它默认启用。
智能体会自动调用 `image_generate`。无需将该工具加入允许列表——当有可用提供商时，它默认启用。
## 支持的提供商
| 提供商 | 默认模型 | 编辑支持 | 认证方式 |
| ------ | -------------------------------- | ---------------------------------- | ------------------------------------------------------- |
| OpenAI | `gpt-image-2` | 是（最多 4 张图像） | `OPENAI_API_KEY` 或 OpenAI Codex OAuth |
| Google | `gemini-3.1-flash-image-preview` | 是 | `GEMINI_API_KEY` 或 `GOOGLE_API_KEY` |
| fal | `fal-ai/flux/dev` | 是 | `FAL_KEY` |
| MiniMax | `image-01` | 是（主体参考） | `MINIMAX_API_KEY` 或 MiniMax OAuth（`minimax-portal`） |
| ComfyUI | `workflow` | 是（1 张图像，由工作流配置决定） | 云端使用 `COMFY_API_KEY` 或 `COMFY_CLOUD_API_KEY` |
| Vydra | `grok-imagine` | 否 | `VYDRA_API_KEY` |
| xAI | `grok-imagine-image` | 是（最多 5 张图像） | `XAI_API_KEY` |
| 提供商 | 默认模型 | 编辑支持 | 认证 |
| ---------- | --------------------------------------- | ---------------------------------- | ----------------------------------------------------- |
| OpenAI | `gpt-image-2` | 是（最多 4 张图像） | `OPENAI_API_KEY` 或 OpenAI Codex OAuth |
| OpenRouter | `google/gemini-3.1-flash-image-preview` | 是（最多 5 张输入图像） | `OPENROUTER_API_KEY` |
| Google | `gemini-3.1-flash-image-preview` | 是 | `GEMINI_API_KEY` 或 `GOOGLE_API_KEY` |
| fal | `fal-ai/flux/dev` | 是 | `FAL_KEY` |
| MiniMax | `image-01` | 是（主体参考） | `MINIMAX_API_KEY` 或 MiniMax OAuth（`minimax-portal`） |
| ComfyUI | `workflow` | 是（1 张图像，由工作流配置） | 云端使用 `COMFY_API_KEY` 或 `COMFY_CLOUD_API_KEY` |
| Vydra | `grok-imagine` | 否 | `VYDRA_API_KEY` |
| xAI | `grok-imagine-image` | 是（最多 5 张图像） | `XAI_API_KEY` |
使用 `action: "list"` 可在运行时检查可用的提供商和模型：
使用 `action: "list"` 在运行时查看可用的提供商和模型：
```
/tool image_generate action=list
@ -70,11 +71,11 @@ Codex OAuth 使用相同的 `openai/gpt-image-2` 模型引用。当配置了
## 工具参数
<ParamField path="prompt" type="string" required>
图像生成提示词。对于 `action: "generate"` 为必填。
图像生成提示词。`action: "generate"` 时必填。
</ParamField>
<ParamField path="action" type="'generate' | 'list'" default="generate">
使用 `"list"` 在运行时检查可用的提供商和模型。
使用 `"list"` 在运行时查看可用的提供商和模型。
</ParamField>
<ParamField path="model" type="string">
@ -82,11 +83,11 @@ Codex OAuth 使用相同的 `openai/gpt-image-2` 模型引用。当配置了
</ParamField>
<ParamField path="image" type="string">
编辑模式下使用的单张参考图像路径或 URL。
编辑模式下的单个参考图像路径或 URL。
</ParamField>
<ParamField path="images" type="string[]">
编辑模式下使用的多张参考图像（最多 5 张）。
编辑模式下的多个参考图像（最多 5 张）。
</ParamField>
<ParamField path="size" type="string">
@ -102,11 +103,11 @@ Codex OAuth 使用相同的 `openai/gpt-image-2` 模型引用。当配置了
</ParamField>
<ParamField path="quality" type="'low' | 'medium' | 'high' | 'auto'">
当提供商支持时使用的质量提示。
提供商支持时的质量提示。
</ParamField>
<ParamField path="outputFormat" type="'png' | 'jpeg' | 'webp'">
当提供商支持时使用的输出格式提示。
提供商支持时的输出格式提示。
</ParamField>
<ParamField path="count" type="number">
@ -122,12 +123,12 @@ Codex OAuth 使用相同的 `openai/gpt-image-2` 模型引用。当配置了
</ParamField>
<ParamField path="openai" type="object">
仅适用于 OpenAI 的提示项：`background`、`moderation`、`outputCompression` 和 `user`。
仅适用于 OpenAI 的提示：`background`、`moderation`、`outputCompression` 和 `user`。
</ParamField>
并非所有提供商都支持全部参数。当某个回退提供商支持接近的几何选项但不支持精确请求值时，OpenClaw 会在提交前重映射为最接近的受支持尺寸、宽高比或分辨率。不受支持的输出提示（例如 `quality` 或 `outputFormat`）会在未声明支持这些功能的提供商上被忽略，并在工具结果中报告。
并非所有提供商都支持所有参数。当回退提供商支持接近的几何选项而非精确请求值时，OpenClaw 会在提交前重新映射为最接近的受支持尺寸、宽高比或分辨率。不受支持的输出提示（如 `quality` 或 `outputFormat`）会在未声明支持这些参数的提供商上被丢弃，并在工具结果中报告。
工具结果会报告实际应用的设置。当 OpenClaw 在提供商回退期间重映射几何参数时，返回的 `size`、`aspectRatio` 和 `resolution` 值会反映实际发送的内容，而 `details.normalization` 会记录从请求值到应用值的转换。
工具结果会报告实际应用的设置。当 OpenClaw 在提供商回退期间重新映射几何参数时，返回的 `size`、`aspectRatio` 和 `resolution` 值会反映实际发送的内容，而 `details.normalization` 会记录从请求值到应用值的转换。
## 配置
@ -139,7 +140,11 @@ Codex OAuth 使用相同的 `openai/gpt-image-2` 模型引用。当配置了
defaults: {
imageGenerationModel: {
primary: "openai/gpt-image-2",
fallbacks: ["google/gemini-3.1-flash-image-preview", "fal/fal-ai/flux/dev"],
fallbacks: [
"openrouter/google/gemini-3.1-flash-image-preview",
"google/gemini-3.1-flash-image-preview",
"fal/fal-ai/flux/dev",
],
},
},
},
@ -150,51 +155,70 @@ Codex OAuth 使用相同的 `openai/gpt-image-2` 模型引用。当配置了
生成图像时，OpenClaw 会按以下顺序尝试提供商：
1. 工具调用中的 **`model` 参数**（如果智能体指定了）
1. 工具调用中的 **`model` 参数**（如果智能体指定了该参数）
2. 配置中的 **`imageGenerationModel.primary`**
3. 按顺序使用 **`imageGenerationModel.fallbacks`**
4. **自动检测**——仅使用有认证支持的提供商默认值：
4. **自动检测**——仅使用基于认证的提供商默认值：
- 先使用当前默认提供商
- 然后按 provider-id 顺序使用其余已注册的图像生成提供商
- 再按提供商 ID 顺序使用其余已注册的图像生成提供商
如果某个提供商失败（认证错误、速率限制等），会自动尝试下一个候选项。如果全部失败，错误信息会包含每次尝试的详细信息。
如果某个提供商失败（认证错误、速率限制等），系统会自动尝试下一个候选项。如果全部失败，错误信息中会包含每次尝试的详细信息。
说明：
- 自动检测会感知认证状态。只有当 OpenClaw 实际能够为某个提供商完成认证时，该提供商默认值才会进入候选列表。
- 自动检测具有认证感知能力。只有当 OpenClaw 实际能够认证某个提供商时，该提供商默认值才会进入候选列表。
- 自动检测默认启用。如果你希望图像生成仅使用显式的 `model`、`primary` 和 `fallbacks`
条目，请设置
`agents.defaults.mediaGenerationAutoProviderFallback: false`。
- 使用 `action: "list"` 可检查当前已注册的提供商、它们的默认模型以及认证环境变量提示。
- 使用 `action: "list"` 查看当前已注册的提供商、它们的默认模型以及认证环境变量提示。
### 图像编辑
OpenAI、Google、fal、MiniMax、ComfyUI 和 xAI 支持编辑参考图像。传入参考图像路径或 URL：
OpenAI、OpenRouter、Google、fal、MiniMax、ComfyUI 和 xAI 支持编辑参考图像。传入参考图像路径或 URL：
```
"把这张照片生成成水彩风格版本" + image: "/path/to/photo.jpg"
"Generate a watercolor version of this photo" + image: "/path/to/photo.jpg"
```
OpenAI、Google 和 xAI 通过 `images` 参数最多支持 5 张参考图像。fal、MiniMax 和 ComfyUI 支持 1 张。
OpenAI、OpenRouter、Google 和 xAI 通过 `images` 参数最多支持 5 张参考图像。fal、MiniMax 和 ComfyUI 支持 1 张。
### OpenRouter 图像模型
OpenRouter 图像生成使用相同的 `OPENROUTER_API_KEY`，并通过 OpenRouter 的 chat completions 图像 API 路由。使用 `openrouter/` 前缀选择 OpenRouter 图像模型：
```json5
{
agents: {
defaults: {
imageGenerationModel: {
primary: "openrouter/google/gemini-3.1-flash-image-preview",
},
},
},
}
```
OpenClaw 会将 `prompt`、`count`、参考图像以及兼容 Gemini 的 `aspectRatio` / `resolution` 提示转发给 OpenRouter。当前内置的 OpenRouter 图像模型快捷方式包括 `google/gemini-3.1-flash-image-preview`、`google/gemini-3-pro-image-preview` 和 `openai/gpt-5.4-image-2`；使用 `action: "list"` 可查看你已配置插件公开的模型。
### OpenAI `gpt-image-2`
OpenAI 图像生成默认使用 `openai/gpt-image-2`。如果配置了
`openai-codex` OAuth 配置文件，OpenClaw 会复用 Codex 订阅聊天模型使用的同一个 OAuth
配置文件，并通过 Codex Responses 后端发送图像请求；它不会对该请求静默回退到
`OPENAI_API_KEY`。若要强制改为直接路由到 OpenAI Images API，请显式配置
`models.providers.openai`，例如设置 API 密钥、自定义基础 URL，
`openai-codex` OAuth 配置文件，OpenClaw 会复用与 Codex 订阅聊天模型相同的 OAuth
配置文件，并通过 Codex Responses 后端发送图像请求；它不会在该请求中静默回退到
`OPENAI_API_KEY`。若要强制使用直接的 OpenAI Images API 路由，请显式配置
`models.providers.openai`，例如设置 API 密钥、自定义 base URL
或 Azure 端点。较旧的
`openai/gpt-image-1` 模型仍然可以显式选择，但新的 OpenAI
`openai/gpt-image-1` 模型仍可显式选择，但新的 OpenAI
图像生成和图像编辑请求应使用 `gpt-image-2`。
`gpt-image-2` 同时支持文生图和通过同一个 `image_generate` 工具进行参考图像编辑。OpenClaw 会将 `prompt`、
`gpt-image-2` 同时支持文本生成图像和通过同一个 `image_generate`
工具编辑参考图像。OpenClaw 会将 `prompt`、
`count`、`size`、`quality`、`outputFormat` 和参考图像转发给 OpenAI。
OpenAI 不会直接接收 `aspectRatio` 或 `resolution`；在可能的情况下，
OpenClaw 会将它们映射为受支持的 `size`，否则工具会将它们报告为
被忽略的覆盖参数。
OpenClaw 会将它们映射为受支持的 `size`，否则工具会将其报告为
被忽略的覆盖项。
OpenAI 专属选项位于 `openai` 对象下：
OpenAI 专用选项位于 `openai` 对象下：
```json
{
@ -209,8 +233,8 @@ OpenAI 专属选项位于 `openai` 对象下：
}
```
`openai.background` 可接受 `transparent`、`opaque` 或 `auto`；透明输出要求 `outputFormat` 为 `png` 或 `webp`。`openai.outputCompression`
适用于 JPEG/WebP 输出。
`openai.background` 接受 `transparent`、`opaque` 或 `auto`；透明输出要求 `outputFormat` 为 `png` 或 `webp`。`openai.outputCompression`
适用于 JPEG / WebP 输出。
生成一张 4K 横向图像：
@ -230,49 +254,48 @@ OpenAI 专属选项位于 `openai` 对象下：
/tool image_generate action=generate model=openai/gpt-image-2 prompt="Keep the subject, replace the background with a bright studio setup" image=/path/to/reference.png size=1024x1536
```
使用多张参考图像进行编辑：
使用多个参考图像进行编辑：
```
/tool image_generate action=generate model=openai/gpt-image-2 prompt="Combine the character identity from the first image with the color palette from the second" images='["/path/to/character.png","/path/to/palette.jpg"]' size=1536x1024
```
若要将 OpenAI 图像生成路由到 Azure OpenAI 部署而不是
`api.openai.com`，请参阅 OpenAI 提供商文档中的 [Azure OpenAI endpoints](/zh-CN/providers/openai#azure-openai-endpoints)。
若要将 OpenAI 图像生成通过 Azure OpenAI 部署而不是
`api.openai.com` 路由，请参阅 OpenAI 提供商文档中的 [Azure OpenAI endpoints](/zh-CN/providers/openai#azure-openai-endpoints)。
MiniMax 图像生成同时支持两种内置的 MiniMax 认证路径：
MiniMax 图像生成可通过两种内置的 MiniMax 认证路径使用：
- `minimax/image-01` 用于 API 密钥配置
- `minimax-portal/image-01` 用于 OAuth 配置
## 提供商能力
| 能力 | OpenAI | Google | fal | MiniMax | ComfyUI | Vydra | xAI |
| 能力 | OpenAI | Google | fal | MiniMax | ComfyUI | Vydra | xAI |
| --------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | ---------------------------------- | ------- | -------------------- |
| 生成 | 是（最多 4 张） | 是（最多 4 张） | 是（最多 4 张） | 是（最多 9 张） | 是（输出数量由工作流决定） | 是（1 张） | 是（最多 4 张） |
| 编辑 / 参考图 | 是（最多 5 张图像） | 是（最多 5 张图像） | 是（1 张图像） | 是（1 张图像，主体参考） | 是（1 张图像，由工作流配置决定） | 否 | 是（最多 5 张图像） |
| 尺寸控制 | 是（最高 4K） | 是 | 是 | 否 | 否 | 否 | 否 |
| 宽高比 | 否 | 是 | 是（仅生成） | 是 | 否 | 否 | 是 |
| 分辨率（1K/2K/4K） | 否 | 是 | 是 | 否 | 否 | 否 | 是（1K/2K） |
| 生成 | 是（最多 4 张） | 是（最多 4 张） | 是（最多 4 张） | 是（最多 9 张） | 是（由工作流定义输出） | 是（1 张） | 是（最多 4 张） |
| 编辑 / 参考图 | 是（最多 5 张图像） | 是（最多 5 张图像） | 是（1 张图像） | 是（1 张图像，主体参考） | 是（1 张图像，由工作流配置） | 否 | 是（最多 5 张图像） |
| 尺寸控制 | 是（最高 4K） | 是 | 是 | 否 | 否 | 否 | 否 |
| 宽高比 | 否 | 是 | 是（仅生成） | 是 | 否 | 否 | 是 |
| 分辨率（1K / 2K / 4K） | 否 | 是 | 是 | 否 | 否 | 否 | 是（1K / 2K） |
### xAI `grok-imagine-image`
内置 xAI 提供商在仅提示词请求时使用 `/v1/images/generations`，
而在存在 `image` 或 `images` 时使用 `/v1/images/edits`。
内置的 xAI 提供商在仅提示词请求时使用 `/v1/images/generations`，
当存在 `image` 或 `images` 时使用 `/v1/images/edits`。
- 模型：`xai/grok-imagine-image`、`xai/grok-imagine-image-pro`
- 数量：最多 4 张
- 参考图：单个 `image` 或最多五个 `images`
- 参考图：一个 `image` 或最多五个 `images`
- 宽高比：`1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`2:3`、`3:2`
- 分辨率：`1K`、`2K`
- 输出：以 OpenClaw 管理的图像附件形式返回
OpenClaw 有意不公开 xAI 原生的 `quality`、`mask`、`user` 或
其他仅原生支持的宽高比，直到这些控制项在跨提供商共享的
`image_generate` 契约中具备支持。
在这些控制项存在于跨提供商共享的 `image_generate` 契约之前，
OpenClaw 有意不公开 xAI 原生的 `quality`、`mask`、`user` 或额外的仅原生宽高比选项。
## 相关内容
- [工具概览](/zh-CN/tools) — 所有可用的智能体工具
- [Tools Overview](/zh-CN/tools) — 所有可用的智能体工具
- [fal](/zh-CN/providers/fal) — fal 图像和视频提供商设置
- [ComfyUI](/zh-CN/providers/comfy) — 本地 ComfyUI 和 Comfy Cloud 工作流设置
- [Google (Gemini)](/zh-CN/providers/google) — Gemini 图像提供商设置
@ -280,5 +303,5 @@ OpenClaw 有意不公开 xAI 原生的 `quality`、`mask`、`user` 或
- [OpenAI](/zh-CN/providers/openai) — OpenAI Images 提供商设置
- [Vydra](/zh-CN/providers/vydra) — Vydra 图像、视频和语音设置
- [xAI](/zh-CN/providers/xai) — Grok 图像、视频、搜索、代码执行和 TTS 设置
- [配置参考](/zh-CN/gateway/configuration-reference#agent-defaults) — `imageGenerationModel` 配置
- [模型](/zh-CN/concepts/models) — 模型配置和故障切换
- [Configuration Reference](/zh-CN/gateway/configuration-reference#agent-defaults) — `imageGenerationModel` 配置
- [Models](/zh-CN/concepts/models) — 模型配置和故障转移