运行时依赖
安装命令
点击复制本土化适配说明
image-agent-plus 安装说明: 安装命令:["openclaw skills install image-agent-plus"]
技能文档
image-agent-plus 直接 CLI 调用,无需 HTTP 服务器。 展示:上图由本地生成,提示词为「AI 时代,我们应该沉淀下来的是什么,中文社论海报」。作为 ClawHub 商店预览,方便用户安装前查看预期输出风格。
Setup 踩坑 最初把 Codex 图像生成当作普通嵌套 CLI provider,失败。正确流程:
- 在活跃 Codex 会话内生成图像;
- Codex 将结果存至
~/.codex/generated_images//ig_.png; - 执行
image-agent-plus collect-codex把最新图复制到指定路径。
codex exec 生成图像,会卡死或失败,因交互式 Codex 图像工具事件 ≠ 非交互 shell 命令。 Runtime 规则
索要 API key 前,先跑:
image-agent-plus check
若已设 OpenAI API key(IMAGE_AGENT_OPENAI_API_KEY 或 OPENAI_API_KEY),默认走 image2;
若本地装有 Codex CLI 或 Gemini CLI(无 OpenAI key),免 key 直接调用;
API key 仅用于直连 provider API 或无本地运行环境场景。
Quick Start
image-agent-plus generate \
--prompt "一只橘猫坐在雨天窗台上,电影感光线" \
--aspect-ratio "16:9"
常用命令
image-agent-plus check # 默认:有 key 走 OpenAI image2
image-agent-plus generate \
--prompt "AI 时代,我们应该沉淀下来的是什么,中文社论海报" \
--aspect-ratio "16:9" # 无 key 回退:Codex CLI
image-agent-plus generate \
--prompt "AI 时代,我们应该沉淀下来的是什么,中文社论海报" \
--provider codex \
--aspect-ratio "16:9"
Codex 生成:先用活跃会话的 Codex image tool,待提示「Generated Image」并保存后,执行:
image-agent-plus collect-codex选项
Flag | 说明
--prompt | 图像描述,必填
--provider | openai / codex / gemini
--filename | 输出路径;留空则存至 ~/Desktop/image-agent-plus-output/
--aspect-ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9
--model | 指定 provider 模型 ID;Codex CLI 默认生成时勿传
--output-count | 一次生成张数,1-8
Codex 收集
image-agent-plus collect-codex --filename ~/Desktop/output.png
若省略 --filename,图复制到 ~/Desktop/image-agent-plus-output/。 环境
优先本地 runtime;image2 直连 API 模式需提前在 shell 或 agent secret 管理器配置 OpenAI key。CLI 仍兼容旧 NANOBANANA_ 变量作回读。