OpenClaw 图片生成

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

准备工作

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

处理方式：

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

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

获取 accessKey

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

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

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

将 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

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

根据参考图生成图片

运行：

python scripts/generate_image.py --prompt "Keep the product shape and create a premium launch poster" --reference-image "C:\path\product.png" --size 3:2 --resolution 2K

每张本地参考图都使用一次 --reference-image 参数。脚本会先上传参考图，再调用生成接口。

返回结果

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

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

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