前言¶
在 Cursor、Claude Code 等环境里做图片，常见做法是临时写一段调用脚本，或把提示词交给通用对话模型「描述一张图」。前者要自己处理鉴权、参考图上传和异步任务轮询；后者往往拿不到可直接使用的图片 URL。若你已经在用 OpenClaw 平台的图片能力，更希望 Agent 按固定流程生成、改图并返回可追踪的任务结果，可以把逻辑收敛到一个 SkillHub 技能里。下面介绍社区技能 gpt-image-openclaw（坐标 @user_07ea056c/gpt-image-2-new）的定位、能力与安装方式。
这是什么¶
gpt-image-openclaw 是 SkillHub 上分类为 design-media 的社区技能（来源 community，发布者 user_07ea056c，当前版本 1.0.2）。它通过 OpenClaw 平台完成作图、文生图、图生图、图片编辑，以及商品图、电商主图、套图、详情页图、营销海报和社媒配图等需求；当用户要按提示词生成新图、基于参考图改图/换风格，或制作多张可分别使用的电商素材时，技能说明要求 Agent 优先启用本技能。
技能包内自带 scripts/generate_image.py，统一处理 accessKey 读取、参考图压缩上传、任务创建、积分预估与轮询，并在本地维护 openclaw_tasks.json 记录任务状态。SkillHub 页面标注 requires_api_key=true，使用前需配置 OpenClaw 的 accessKey。
核心功能¶
以下能力均来自技能包 SKILL.md 与脚本实现，可与官方简介对照：
- 文生图：仅提供提示词时，调用 OpenClaw 创建生成任务并轮询至完成。
- 参考图生图 / 图生图：通过多次
--reference-image传入本地参考图；超过 4MB 的图会先压缩再上传，不覆盖本地原文件。 - GPT 图片模型与质量档：默认模型别名
gpt-image-vip（与gpt-image-2、gpt-image-2-vip按同一类 GPT 图片模型处理）；支持low/medium/high（及中文「低 / 中 / 高」）。脚本还支持nano-banana-pro、nano-banana2。 - 尺寸与清晰度：通过
--size（画幅比例，如1:1、3:2）和--resolution（如1K、2K、4K）控制输出。 - 积分预估：创建任务前打印
estimated_credits；文档内置 1K/2K/4K 各质量档的预估表，最终以 API 的credits_charged为准。 - 电商多图拆分：当提示词出现「第一张图」「套图」「image set」等表述时，技能要求拆成多个独立任务，保持产品主体与风格一致，并按编号或用途分组返回。
- 任务恢复：未完成的历史任务会在下次运行脚本时继续轮询，避免长任务中断后丢失进度。
安装与启用¶
通过 SkillHub CLI 安装¶
先确认本机已安装 skillhub（安装说明见 SkillHub 安装文档）。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
skillhub install @user_07ea056c/gpt-image-2-new --dir ~/.cursor/skills/
常用目录（与官方安装文档一致）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
SkillHub 页面也支持将下面提示交给 AI，让其按同一文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_07ea056c/gpt-image-2-new。
配置 OpenClaw 鉴权¶
在技能目录（与 SKILL.md 同级）复制示例配置并填入密钥：
cp config.example.json config.json
config.example.json 结构如下：
{
"base_url": "https://openclaw.aisupermarket.top",
"access_key": "paste-your-access-key-here"
}
将 access_key 替换为在 https://openclaw.aisupermarket.top 登录后，于 openclaw 能力项目中复制的 accessKey。也可仅对当前 shell 设置环境变量（勿写入日志或公开仓库）：
export OPENCLAW_IMAGE_ACCESS_KEY="your-access-key"
export OPENCLAW_IMAGE_BASE_URL="https://openclaw.aisupermarket.top"
典型用法¶
在技能包根目录（含 scripts/ 的目录）执行 Python 脚本。路径以你安装后的实际目录为准，例如 ~/.cursor/skills/@user_07ea056c/gpt-image-2-new/。
文生图¶
用户只给提示词、无参考图时使用：
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
未明确要求质量时，技能文档建议默认 medium；强调省积分用 low，强调高清商用用 high。
参考图生图¶
每张本地参考图重复一次 --reference-image：
python scripts/generate_image.py \
--prompt "Keep the product shape and create a premium launch poster" \
--reference-image "/path/to/product.png" \
--size 3:2 \
--resolution 2K \
--model gpt-image-vip \
--quality medium
成功后脚本输出 JSON，其中包含任务状态、图片 URL，以及 API 返回时的扣费信息；Agent 应按技能说明汇总给用户，且不在回复中暴露 accessKey。
适用场景与注意¶
适合谁：已在 OpenClaw 开通图片能力、希望在 Agent 对话中稳定完成文生图、参考图改图和电商多图素材编排的开发者或运营同学。
平台与社区信息：SkillHub 抓取数据显示该技能评分 100000、下载 2170 次（统计以 SkillHub 页面为准）。标签标明需要 API Key，积分消耗与账号权限以 OpenClaw 平台为准。
使用注意：
accessKey等同密码，不要提交 Git 或出现在截图、公开 issue 中；openclaw_tasks.json仅保存任务状态，不含密钥。- 参考图上传前有 4MB 限制，大图会自动压缩为 JPEG；透明通道会先铺白底。
- 默认轮询间隔 2 秒、超时 300 秒，可通过
--poll-interval、--timeout调整；超时未完成的任务 ID 仍写在openclaw_tasks.json中，下次运行可继续跟轮询。 - 排错时可查阅技能包内
references/api.md，日常生成不必必读。
结尾¶
gpt-image-openclaw 把 OpenClaw 的图片生成流程封装成 Agent 可复用的 SKILL.md 与脚本：配置一次 accessKey，即可在对话里完成文生图、参考图生图和电商套图拆分，并拿到可追踪的任务与图片 URL。
- SkillHub API 页：https://api.skillhub.cn/user_07ea056c/gpt-image-2-new
- SkillHub 展示页：https://www.skillhub.cn/skills/user_07ea056c/gpt-image-2-new
