运行时依赖
无特殊依赖
安装命令
点击复制官方npx clawhub@latest install happy-img2-direct
镜像加速npx clawhub@latest install happy-img2-direct --registry https://cn.longxiaskill.com镜像同步中
技能文档
Happy IMG2 Direct Skill 通过 OpenClaw 中配置的 OpenAI 兼容的 /images/generations 端点生成真实图像。默认行为:
- provider:happy,除非设置了 OPENCLAW_IMAGE_PROVIDER
- model:gpt-image-2,除非设置了 OPENCLAW_IMAGE_MODEL
- size:1024x1024
- timeout:600000ms 每张图像
- output:~/.openclaw/generated-images/
- 不使用本地假图像回退
- 不内置消息传递;使用 OpenClaw/频道工具发送或附加文件
单图像 python3 skills/happy-img2-direct/scripts/run.py \ --prompt "一张现实的橙色猫坐在窗边的照片,无文字,无水印" \ --task-name "cat-test" \ --no-send
有用的标志:
- --prompt 必需
- --task-name 输出文件名前缀
- --provider OpenClaw 配置中的 provider 键,默认 happy
- --model 图像模型,默认 gpt-image-2
- --size 默认 1024x1024
- --timeout-ms 默认 600000
- --output-dir 默认 ~/.openclaw/generated-images
- --max-attempts 默认 3,最大 5
- --retry-base-delay、--retry-max-delay、--retry-jitter
- --raw 标记 caller 故意保持用户提示不变
- --no-send 为了兼容性;此公共技能始终将传递留给 caller
成功输出是包含 ok:true、image_path 或 output、bytes、model/provider、尝试次数和运行目录的 JSON。
批量图像 python3 skills/happy-img2-direct/scripts/batch_run.py @batch.json 示例: { "batch_name": "article-covers", "max_workers": 4, "timeout_ms": 600000, "send_to_feishu": false, "tasks": [ {"task_name": "cover-1", "prompt": "现实的商店柜台照片,无可读文本"}, {"task_name": "cover-2", "prompt": "现实的办公桌照片,无可读文本"} ] }
批量规则:
- 有界并发,当前硬性最大 4
- 每个项目都有自己的任务目录和日志
- 一个失败的图像不会阻止其他图像完成
- 最终的 batch_result.json 记录每个任务的成功/失败
- 在公共版本中禁用传递;使用 OpenClaw/频道工具发送文件
重试行为 重试次数有限,只用于可重试的失败:
- 超时
- 上游失败
- 限速
- HTTP 408/429/500/502/503/504 包装器解析错误
安全和发布说明 此技能故意不包含私有的 OpenClaw ID、硬编码的用户路径、API 密钥和频道接收者 ID。它在运行时从本地 OpenClaw 配置中读取 provider 配置。