Seedream5

使用火山引擎豆包 Seedream 5.0 生成或编辑图片。支持文生图、单图/多图生图、组图、联网搜索。

Security Scan

The skill's code, install steps, and requested credential (VOLC_API_KEY) are consistent with a Volcano Engine Seedream image-generation integration and do not request unrelated secrets or perform unexplained actions.

Purpose & Capability

Name/description claim image generation using Volcano Engine Seedream 5.0; the package only requires a CLI 'uv' runtime and a Volcano API key, and the included script calls the documented Volcano API endpoint. Required items are proportional to the stated purpose.

Instruction Scope

SKILL.md instructs running the provided script via 'uv' with prompts, input-image paths or URLs, and an API key. The script uploads input images (base64 or URL) and writes generated images to disk—behaviour matches the skill purpose. It only reads API key env variables and local input images; nothing in the instructions asks for unrelated system data.

Install Mechanism

Install specifies a single brew formula 'uv' (a known tool for running Python scripts). No downloads from untrusted URLs or archive extraction are present. Script dependencies (requests, pillow) are declared in-file; this is reasonable for the functionality.

Credentials

Only VOLC_API_KEY (primary) or ARK_API_KEY is required, which is exactly the credential needed to call Volcano Engine APIs. No unrelated secrets, config paths, or additional credentials are requested.

Persistence & Privilege

always is false and the skill does not request persistent elevated privileges or modify other skills. It documents configuring keys via openclaw.json or UI, which is normal for credential injection.

Assessment

This skill appears to do what it says: it will send prompts and any provided input images to Volcano Engine's image generation API and save returned images locally. Before installing: 1) Only provide an API key you trust and are willing to use with a third‑party image service (consider a scoped/ephemeral key if available). 2) Do not upload sensitive images (IDs, private photos) because input images are transmitted to the remote API. 3) Verify the 'uv' brew package source on your platform if you care about install provenance. 4) If you use shared or persisted openclaw.json credentials, be aware they are stored locally in that config file and will be injected as VOLC_API_KEY. 5) Review the included script if you need stricter controls (e.g., preventing upload of local files or restricting web-search).

Seedream5 (火山引擎豆包 Seedream 5.0)

使用火山引擎图片生成 API 生成或编辑图片。模型：doubao-seedream-5-0-260128。API 文档：https://www.volcengine.com/docs/82379/1541523

文生图

uv run {baseDir}/scripts/generate_image.py --prompt "你的图片描述" --filename "output.png" --resolution 2K

单图生图

uv run {baseDir}/scripts/generate_image.py --prompt "编辑指令" --filename "output.png" -i "/path/in.png" --resolution 2K

多图生图（2–14 张参考图）

uv run {baseDir}/scripts/generate_image.py --prompt "将这几张图合成一个场景" --filename "output.png" -i img1.png -i img2.png -i img3.png

API Key 配置

本技能需要火山引擎 API Key。任选以下一种方式配置即可。

方式一：环境变量（推荐用于本地开发）

export VOLC_API_KEY="你的API_KEY"
# 或
export ARK_API_KEY="你的API_KEY"

方式二：openclaw.json（推荐用于持久配置）

编辑 ~/.openclaw/openclaw.json（或你的 OPENCLAW_CONFIG_PATH 指向的配置文件），在 skills.entries 下添加：

{
  "skills": {
    "entries": {
      "seedream5": {
        "apiKey": "你的火山引擎API_KEY"
      }
    }
  }
}

OpenClaw 会将 apiKey 注入为 VOLC_API_KEY 环境变量，脚本会自动读取。

方式三：ClawPanel / Control UI

若使用 ClawPanel 或 OpenClaw Control UI，在 Skills 页面找到 seedream5，在凭证/API Key 字段中填写即可。

获取 API Key

前往 火山引擎控制台 获取长效 API Key。

可选参数

指定宽高比

uv run {baseDir}/scripts/generate_image.py --prompt "竖屏人像" --filename "output.png" --aspect-ratio 9:16

不添加水印

uv run {baseDir}/scripts/generate_image.py --prompt "..." --filename "output.png" --no-watermark

组图模式（多张关联图片）

uv run {baseDir}/scripts/generate_image.py --prompt "生成3张不同时段场景" --filename "out.png" -i ref.png --sequential auto --max-images 3

联网搜索（天气、实时信息等）

uv run {baseDir}/scripts/generate_image.py --prompt "上海未来5日天气预报图" --filename "weather.png" --web-search

输入图支持 URL

uv run {baseDir}/scripts/generate_image.py --prompt "换装" --filename "out.png" -i "https://example.com/ref.png"

分辨率与宽高比

• 分辨率：2K、3K（doubao-seedream-5-0-260128 支持）
• 宽高比：1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
• 建议在文件名中使用时间戳：yyyy-mm-dd-hh-mm-ss-name.png
• 脚本会输出 MEDIA:<path> 供 OpenClaw 在支持的聊天渠道中自动附加
• 不要读取图片内容回传，仅报告保存路径即可