OpenClaw 图片生成

使用本技能自带的脚本生成图片，确保鉴权、参考图上传、任务创建、质量等级、积分预估和任务轮询逻辑保持一致。

准备工作

1. 优先读取本文件同级目录下的 config.json。
2. 如果 config.json 不存在，引导用户复制 config.example.json 为 config.json，并填入 OpenClaw 的 accessKey。
3. 如果用户还没有 accessKey，按照 获取 accessKey 的步骤引导用户。
4. 不要在回复、日志或生成文件中暴露用户的 accessKey。
5. 只有在需要查看请求字段、任务状态或排错细节时，才阅读 references/api.md。

脚本也支持通过环境变量 OPENCLAW_IMAGE_ACCESS_KEY 和 OPENCLAW_IMAGE_BASE_URL 传入配置。对于下载后本地使用的场景，优先推荐使用 config.json。

多图需求拆分

当提示词中明确提到多张图片、图片序号或电商套图时，通常说明用户想要一组可分别使用的电商素材。此时应将需求拆分为多个图片生成任务，而不是试图把所有内容放进同一张图里。

常见触发词包括：

• 第一张图、第二张图、第三张图
• first image、second image、third image
• 套图、电商套图、详情页套图、主图套图
• set、image set、product image set

处理方式：

1. 识别每张图的用途，例如主图、场景图、细节特写、对比图、包装图、促销横幅等。
2. 每张图创建一个独立的生成任务。
3. 多个任务之间保持产品主体、品牌信息、整体风格、画幅比例和参考图要求一致。
4. 针对每张图的具体用途，分别改写或细化提示词。
5. 返回结果时按照图片编号或图片用途分组，方便电商用户直接使用。

如果用户在同一个提示词中写了多个编号要求，输出结果时应保留原有编号。

获取 accessKey

生成图片前，用户需要先获取 OpenClaw 的 accessKey。

1. 打开 https://openclaw.aisupermarket.top。
2. 登录或注册账号。
3. 进入 openclaw 能力项目。
4. 找到并复制该项目的 accessKey。
5. 将 accessKey 直接发送给执行图片生成任务的 agent，例如 Claude Code 或 OpenClaw；也可以保存到本地配置文件。
6. 如果选择本地配置，在本文件同级目录创建 config.json：

{
  "base_url": "https://openclaw.aisupermarket.top",
  "access_key": "paste-your-access-key-here"
}

7. 将 paste-your-access-key-here 替换为复制到的 accessKey。

accessKey 应像密码一样保管。可以为了当前任务直接提供给可信的本地 agent 使用，但不要提交到 Git，也不要公开到截图、日志、公开 issue 或共享文档中。

如果用户找不到 openclaw 能力项目或其中的 accessKey，请引导用户联系 OpenClaw 平台管理员，为账号开通对应访问权限。

也可以只为当前 shell 会话设置环境变量：

export OPENCLAW_IMAGE_ACCESS_KEY="your-access-key"

Windows PowerShell：

$env:OPENCLAW_IMAGE_ACCESS_KEY = "your-access-key"

根据文本生成图片

运行：

python scripts/generate_image.py --prompt "A clean product hero image for a black smartwatch on glass" --size 1:1 --resolution 1K --model gpt-image-vip --quality medium

当用户只提供提示词、没有提供参考图时，使用文本生成图片。

GPT 图片模型和质量等级

默认使用 gpt-image-vip。脚本会将 gpt-image-vip、gpt-image-2-vip 和 gpt-image-2 作为同一类 GPT 图片模型处理，并向 OpenClaw API 发送兼容字段。

GPT 图片模型支持 3 个质量等级：

• --quality low 或 --quality 低
• --quality medium 或 --quality 中
• --quality high 或 --quality 高

质量越高，消耗积分越多。当前技能内置预估表：

脚本会在创建任务前打印 estimated_credits 作为预估；最终扣费以 OpenClaw API 返回的 credits_charged 或平台积分记录为准。

如用户没有明确要求质量，默认使用 medium，兼顾生成效果和积分消耗。用户明确要求“省积分、快速草稿、低成本试图”时再选择 low；明确要求“高清、更好质量、精修、商用高质量”时再选择 high。

根据参考图生成图片

运行：

python scripts/generate_image.py --prompt "Keep the product shape and create a premium launch poster" --reference-image "C:pathproduct.png" --size 3:2 --resolution 2K --model gpt-image-vip --quality medium

每张本地参考图都使用一次 --reference-image 参数。脚本会先检查参考图大小：如果参考图超过 4M，会自动压缩到 4M 以下再上传；然后再调用生成接口。

压缩规则：

1. 优先保持原图内容和画面比例。
2. 超过 4M 的参考图会自动重新编码为压缩 JPEG。
3. 如果参考图有透明通道，压缩前会先使用白色背景合成。
4. 压缩只影响上传给 OpenClaw 的参考图数据，不会覆盖用户本地原图。

任务存储和恢复

脚本会在本技能目录下自动维护 openclaw_tasks.json，用于记录图片生成任务，避免长任务或中断后丢失进度。

存储内容包括：

• 任务 ID
• 当前状态
• 图片 URL
• 创建时间
• 最近更新时间

运行规则：

1. 创建新的生图任务后，立即把任务 ID 和初始状态写入 openclaw_tasks.json。
2. 每次轮询任务状态后，更新存储中的状态和图片 URL。
3. 每次启动脚本时，自动读取 openclaw_tasks.json 中尚未完成的任务。
4. 尚未完成的历史任务会和本次新建任务一起加入轮询循环。
5. 已完成或失败的任务会保留在存储中，方便后续追踪任务 ID、状态和图片 URL。

openclaw_tasks.json 不保存 accessKey。它是运行时状态文件，不应作为配置模板分发。

返回结果

返回最终图片 URL 和最有用的生成信息：

• 任务状态
• 提示词摘要
• 图片尺寸和清晰度
• 模型和质量等级
• 可用时返回任务 ID
• API 返回时显示消耗的点数

如果生成失败，报告 API 错误，并说明失败发生在哪个阶段：配置检查、参考图上传、任务创建或任务轮询。