phoenixclaw image gen

图像生成辅助

为 OpenClaw 提供原生的图像生成能力，通过文字描述词快速生成高质量图像。

工作流程 用户提示词 (Prompt) ↓ ┌─────────────────────────────────────┐ │ 识别参数：模型、尺寸、比例、路径 │ └─────────────────────────────────────┘ ↓ ┌─────────────────────────────────────┐ │ 调用 Open路由r 接口 (OpenClaw) │ └─────────────────────────────────────┘ ↓ ┌─────────────────────────────────────┐ │ 默认模型：种子ream-4.5 (Text-to-Image) & Gemini 2.5 (Image-to-Image) │ └─────────────────────────────────────┘ ↓ ┌─────────────────────────────────────┐ │ 原子化写入本地存储 (Safety First) │ └─────────────────────────────────────┘ ↓ 返回结构化 JSON (成功 Payload)

安装与配置

• 获取 API Key

本技能需要 Open路由r API Key 才能调用图像生成服务。

访问 Open路由r 控制台 创建 API Key 请根据下方指引手动配置环境变量

• 配置到环境变量

根据 OpenClaw 官方最佳实践，请通过 ~/.OpenClaw/OpenClaw.json 配置环境变量：

{ 技能s: { entries: { "image-generation": { enabled: true, env: { OPEN路由R_API_KEY: "sk-or-v1-xxxxxxxx..." } } } } }

或使用 primaryEnv 快捷配置：

{ 技能s: { entries: { "image-generation": { enabled: true, APIKey: "sk-or-v1-xxxxxxxx..." } } } }

配置完成后无需重启，新配置会在下次运行 OpenClaw 时自动生效。

• 选择默认模型（可选）

本技能默认使用 bytedance-种子/种子ream-4.5 作为文本生图模型，google/gemini-2.5-flash-image 作为图生图模型。你可以通过以下方式更改：

方式一：环境变量配置 在 ~/.OpenClaw/OpenClaw.json 中添加：

{ 技能s: { entries: { "image-generation": { enabled: true, env: { OPEN路由R_API_KEY: "sk-or-v1-xxx", IMAGE_GEN_TEXT_TO_IMAGE_模型: "bytedance-种子/种子ream-4.5", IMAGE_GEN_IMAGE_TO_IMAGE_模型: "google/gemini-2.5-flash-image" } } } } }

本技能默认使用 bytedance-种子/种子ream-4.5 模型，你可以通过以下方式更改：

方式一：环境变量配置 在 ~/.OpenClaw/OpenClaw.json 中添加：

{ 技能s: { entries: { "image-generation": { enabled: true, env: { OPEN路由R_API_KEY: "sk-or-v1-xxx", IMAGE_GEN_IMAGE_TO_IMAGE_模型: "google/gemini-2.5-flash-image", IMAGE_GEN_TEXT_TO_IMAGE_模型: "bytedance-种子/种子ream-4.5" } } } }

方式二：查看可用模型

node 技能s/image-generation/scripts/命令行工具/open路由r.js --列出-模型s

方式三：生成时指定模型

node 技能s/image-generation/scripts/生成.js \ --prompt "a futuristic city" \ --模型 "bytedance-种子/种子ream-4.5" \ --i2i-模型 "google/gemini-2.5-flash-image"

node 技能s/image-generation/scripts/生成.js \ --prompt "a futuristic city" \ --image "bytedance-种子/种子ream-4.5" \ --模型 "google/gemini-2.5-flash-image"

推荐模型：

bytedance-种子/种子ream-4.5 - 默认，高质量图像生成 anthropic/claude-3.5-sonnet-image - Claude 图像生成 openAI/dall-e-3 - DALL-E 3

• 验证配置

预期输出：

{ "成功": true, "message": "Open路由r API key is 配置d. Test passed." }

核心配置 仅限 Open路由r (v1)

本技能在 v1 版本中仅支持通过 Open路由r 提供商进行图像生成。目前不原生支持 Anthropic、Replicate 或 Stability AI 等直接接口。所有生图请求均通过 Open路由r 统一中转。

默认模型 文本生图模型 (Text-to-Image): bytedance-种子/种子ream-4.5 图生图模型 (Image-to-Image): google/gemini-2.5-flash-image 获取地址: Open路由r | bytedance-种子/种子ream-4.5 OpenClaw 调用方式 命令调用

OpenClaw 会通过以下 命令行工具 方式触发图像生成：

# 基础生成 node 技能s/image-generation/scripts/生成.js \ --prompt "a futuristic city at sun设置" \ --输出 "输出s/city.png"

# 指定模型、尺寸与比例 (Open路由r 默认) node 技能s/image-generation/scripts/生成.js \ --prompt "cyberpunk landscape" \ --模型 "bytedance-种子/种子ream-4.5" \ --i2i-模型 "google/gemini-2.5-flash-image" \ --size "2K" \ --aspect "16:9"

node 技能s/image-generation/scripts/生成.js \ --prompt "cyberpunk landscape" \ --image "bytedance-种子/种子ream-4.5" \ --模型 "google/gemini-2.5-flash-image" \ --size "2K" \ --aspect "16:9"

# 通过 OpenClaw 包装器调用 node 技能s/image-generation/scripts/命令行工具/open路由r.js \ --prompt "abstract oil pAInting" \ --size "1K"

预检测 (Connectivity 检查)

OpenClaw 在启动时可运行以下脚本检查 API 连通性：

```bash node 技能s/image-generation/scripts/命令行工具/open路由r.js --test

参数详解 参数 说明 必填 默认值 --prompt 图像描述词 是 - --模型 文本生图模型 ID 否 bytedance-种子/种子ream-4.5 --i2i-模型 图生图模型 ID 否 google/gemini-2.5-flash-image --输入-image 图生图输入图片路径 否 - --列出-模型s 列出所有可用模型 否 - --size 分辨率等级 (1K|2K|4K) 否 模型默认 --aspect 宽高比 (如 1:1, 16:9) 否 1:1 --输出 输出文件路径 否 .sisyphus/生成d/image_.png

|------|------|------|--------| | --prompt | 图像描述词 | 是 | - | || --模型 | 图生图模型 ID | 否 | google/gemini-2.5-flash-image | || --image | 文本生图模型 ID | 否 | bytedance-种子/种子ream-4.5 | | --列出-模型s | 列出所有可用模型 | 否 | - | | --size | 分辨率等级 (1K|2K|4K) | 否 | 模型默认 | | --aspect | 宽高比 (如 1:1, 16:9) | 否 | 1:1 | | --输出 | 输出文件路径 | 否 | .sisyphus/生成d/image_.png | | --输出 | 输出文件路径 | 否 | .sisyphus/生成d/image_.png |

分辨率与尺寸说明

--size 参数格式：

只接受三个字符串值："1K"、"2K"、"4K" 不要 使用像素格式如 "1024x1024" 或 "3840x2160"（Open路由r API 不接受）

实际输出像素尺寸（由 size 和 aspect 共同决定）：

size aspect 实际像素 说明 1K 1:1 1024×1024 默认，约 1MP 1K 16:9 ~1280×720 约 0.9MP 2K 1:1 2048×2048 约 4MP 2K 16:9 ~2560×1440 约 3.7MP 4K 1:1 4096×4096 约 16MP 4K 16:9 384