OpenClaw 图片生成

要解决的问题

在本地 agent 中调用图片生成 API 时，常见问题是：鉴权配置散乱、参考图超限、多图需求被混进一张图、长任务中断后丢失进度。gpt-image-openclaw 把这些流程收敛成一套脚本化的调用方式。

技能如何工作

• 配置与鉴权：优先读取同级 config.json，也可用 OPENCLAW_IMAGE_ACCESS_KEY 与 OPENCLAW_IMAGE_BASE_URL 环境变量；不回复或日志中暴露密钥。
• 生成模式：支持纯文本生成，也支持通过 --reference-image 传入本地参考图；超过 4M 的参考图会自动压缩为 JPEG，透明背景会先合成白色背景。
• 多图拆分：遇到“第一张图、套图、product image set”等表达时，会拆成多个独立任务，并保持产品主体、风格、比例一致。
• 质量与积分：默认 medium，可选 low / high；创建任务前打印 estimated_credits，最终扣费以 OpenClaw API 返回为准。
• 任务恢复：使用 openclaw_tasks.json 记录任务 ID、状态、图片 URL，并在下次启动时继续轮询未完成历史任务。

适用边界与注意点

适合本地脚本化生成电商素材、详情页套图、主图、场景图等需要分别下载和复用的图片任务。密钥应像密码一样保管；该文件不保存密钥。质量越高积分消耗越大，失败时会提示发生在配置检查、参考图上传、任务创建或任务轮询哪个阶段。