Nano-banana 图像生成与编辑 Skill。支持文生图和图生图,根据文字描述或参考图使用 AI 生成/编辑图像,自动压缩大图,保存到 workspace/img 目录,并直接在飞书中展示。 触发场景:用户要求生成图片、画图、AI 绘图、创建图像、修改图片、基于图片生成、图生图。
使用 Nano-banana-3.1-Flash API 进行图像生成与编辑,支持:
自动压缩超过 1MB 的图片,保存到 workspace,并直接在飞书中展示。
在workspace目录下创建 .env 文件:
# .env
IMAGE_API_BASE_URL=https://api.imyaigc.top
IMAGE_API_KEY=your-api-key-here
IMAGE_MODEL=gemini-3.1-flash-image-preview
IMAGE_SIZE=2K
IMAGE_ASPECT_RATIO=1:1
所有生成的图片保存在:
~/.openclaw/workspace/img/
文件名格式:image_YYYYMMDD_HHMMSS.png
压缩规则:
image_YYYYMMDD_HHMMSS_original.pngimage_YYYYMMDD_HHMMSS.png直接告诉我要生成什么图片:
示例:
提供参考图和修改描述:
示例:
工作流程:
image 参数解析参数
调用 API
curl -X POST "${IMAGE_API_BASE_URL}/v1/images/generations" \
-H "Authorization: Bearer ${IMAGE_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "'"${IMAGE_MODEL}"'",
"prompt": "描述内容",
"response_format": "url",
"aspect_ratio": "16:9"
}'
获取参考图
调用 API
curl -X POST "${IMAGE_API_BASE_URL}/v1/images/generations" \
-H "Authorization: Bearer ${IMAGE_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "'"${IMAGE_MODEL}"'",
"prompt": "修改描述(如:改为水彩风格)",
"response_format": "url",
"aspect_ratio": "16:9",
"image": ["data:image/png;base64,iVBORw0KGgo..."]
}'
获取图片 URL
data[0].url下载并保存原始图片
OUTPUT_DIR=~/.openclaw/workspace/img
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
ORIGINAL_FILE="${OUTPUT_DIR}/image_${TIMESTAMP}_original.png"
FINAL_FILE="${OUTPUT_DIR}/image_${TIMESTAMP}.png"
curl -o "$ORIGINAL_FILE" "$IMAGE_URL"
检查大小并压缩(如需要)
FILE_SIZE=$(stat -f%z "$ORIGINAL_FILE" 2>/dev/null || stat -c%s "$ORIGINAL_FILE")
MAX_SIZE=$((1024 * 1024)) # 1MB
if [ "$FILE_SIZE" -gt "$MAX_SIZE" ]; then
echo "图片超过 1MB,正在压缩..."
python3 compress_image.py "$ORIGINAL_FILE" "$FINAL_FILE" 1
else
cp "$ORIGINAL_FILE" "$FINAL_FILE"
fi
发送到飞书 如果在飞书对话中,注意以下发送方式
message(
action="send",
channel="feishu",
accountId="second",
target="用户或群组ID",
media="~/.openclaw/workspace/img/image_xxx.png"
)
使用 compress_image.py 进行图片压缩:
# 用法
python3 compress_image.py <input> <output> [max_size_mb]
# 示例
python3 compress_image.py original.png compressed.png 1
压缩策略:
1:1 - 正方形(默认)4:3, 3:4 - 标准比例16:9, 9:16 - 宽屏/竖屏2:3, 3:2 - 照片比例4:5, 5:4 - 接近正方形21:9 - 超宽屏1:4, 4:1 - 长条形8:1, 1:8 - 超长条形1K - 适合快速预览2K - 推荐默认(默认)4K - 高清大图512px - 小图data:image/png;base64,... 格式)POST /v1/images/generationsAuthorization: Bearer {{YOUR_API_KEY}}${IMAGE_MODEL} (默认: gemini-3.1-flash-image-preview)https://api.imyaigc.top| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | ✅ | 模型名称 |
| prompt | string | ✅ | 生成描述 |
| response_format | string | ❌ | url 或 b64_json |
| aspect_ratio | string | ❌ | 宽高比 |
| image | array | ❌ | 参考图数组(URL 或 base64) |
| image_size | string | ❌ | 图像尺寸(仅 nano-banana-2 支持) |
~/.openclaw/workspace/
├── img/ # 生成的图片保存目录
│ ├── image_20260302_221900_original.png # 原始图片
│ ├── image_20260302_221900.png # 压缩后(用于发送)
│ └── ...
└── skills/
└── image-gen/
├── SKILL.md # 本说明文件
├── image-gen.sh # 生成脚本
├── compress_image.py # 压缩工具
├── .env # API 配置
└── .env.example # 配置示例
~/.openclaw/workspace/img/ 目录image 参数ZIP package — ready to use