doubao-image OpenClaw Skill

使用火山引擎豆包模型生成图片。通过火山引擎豆包图片生成 API 创建图片。支持自定义提示词、尺寸、模型等参数。使用方式:生图:一只可爱的小猫。

v1.0.4 Recently Updated Updated Today

Installation

clawhub install doubao-image-openclaw

Requires npm i -g clawhub

341

Downloads

1

Stars

0

current installs

0 all-time

3

Versions

doubao-image - 豆包图片生成

使用火山引擎豆包模型生成图片。

简介

通过火山引擎豆包图片生成 API 创建图片。支持多模型自动切换、URL 输出等功能。

环境变量

变量名 必填 说明
VOLCENGINE_IMAGE_API_KEY Yes 豆包 API Key
DOUBAO_IMAGE_OUTPUT_DIR No 图片输出目录(默认:workspace/downloads/images)

Get API Key:

  1. Login https://console.volces.com/
  2. Go to API Key management
  3. Copy your API Key

使用方式

生图:一只可爱的小猫

命令行参数

参数 说明 默认值
prompt 图片描述 (必填)
--model 使用的模型 doubao-seedream-4-0-250828
--size 图片尺寸 1024x1024
--num 生成数量 1
--url-only 仅返回 URL,不下载 false

支持的模型(自动切换)

按优先级排序,优先使用第一个,失败则自动尝试下一个:

  1. doubao-seedream-4-0-250828 (默认)
  2. doubao-seedream-4-5-251128
  3. doubao-seedream-5-0-260128
  4. doubao-seedream-3-0-t2i-250415

支持的尺寸

  • 1024x1024 (默认)
  • 1280x720
  • 720x1280
  • 1024x768
  • 768x1024

输出格式

控制台输出

==================================================
Prompt: a cute kitten
Size: 1024x1024
Num: 1
==================================================
Trying model: doubao-seedream-4-0-250828
[OK] Model doubao-seedream-4-0-250828 success

==================================================
Success!
Model: doubao-seedream-4-0-250828
URL: https://...
==================================================

Downloading to: C:\Users\zcf\.openclaw\workspace\downloads\images\doubao_1234567890.jpeg
[OK] Saved: C:\Users\zcf\.openclaw\workspace\downloads\images\doubao_1234567890.jpeg
  Size: 256.5 KB

[FILE_PATH] C:\Users\zcf\.openclaw\workspace\downloads\images\doubao_1234567890.jpeg

特殊标记

  • [URL_ONLY] <url> - 仅生成 URL 时的输出
  • [FILE_PATH] <path> - 文件保存路径

输出目录

图片自动保存到 downloads/images/ 目录。

可通过环境变量自定义:

# Windows
set DOUBAO_IMAGE_OUTPUT_DIR=D:\my_images

# Linux/Mac
export DOUBAO_IMAGE_OUTPUT_DIR=/path/to/images

重要说明

  • API Key: 从 VOLCENGINE_IMAGE_API_KEY 环境变量读取
  • Multi-model fallback: 如果默认模型失败,会自动尝试备选模型
  • URL Output: 生成后立即输出图片 URL

错误处理

  • 如果所有模型都失败,会显示具体错误信息
  • 如果下载失败,仍会输出 URL 供手动下载

Statistics

Downloads 341
Stars 1
Current installs 0
All-time installs 0
Versions 3
Comments 1
Created Mar 13, 2026
Updated Apr 4, 2026

Latest Changes

v1.0.4 · Mar 16, 2026

Version 1.0.3 changelog: - Added multi-model automatic fallback: if the default model fails, alternative models are tried sequentially. - Added support for outputting only the image URL without downloading. - Allowed custom output image directory via `DOUBAO_IMAGE_OUTPUT_DIR` environment variable. - Improved output with special tags for URL and file path. - Documentation updated for clearer usage steps, command-line arguments, and output format details.

Quick Install

clawhub install doubao-image-openclaw
EU Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.