dvcrn 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 在支持的聊天渠道中自动附加 - 不要读取图片内容回传，仅报告保存路径即可