运行时依赖
安装命令
点击复制技能文档
image-agent-plus 直接 CLI 调用,无需 HTTP 服务器。 展示:上图由本地提示“AI 时代,我们应该沉淀下来的是什么,中文社论海报”生成,作为 ClawHub 商店预览,供用户安装前查看输出风格。
安装踩坑 最初把 Codex 图像生成当作普通嵌套 CLI provider,失败。正确流程:
- 在活跃 Codex 会话内生成图像,结果保存在 ~/.codex/generated_images//ig_.png
- 执行 image-agent-plus collect-codex,将最新图复制到指定路径
运行前检查 索要 API 密钥前,先运行: image-agent-plus check
密钥逻辑 若已设 OpenAI API 密钥(IMAGE_AGENT_OPENAI_API_KEY 或 OPENAI_API_KEY),默认走 image2。 若未设密钥但装有 Codex CLI 或 Gemini CLI,直接调用,无需密钥。 密钥仅用于直连 provider API 或无本地运行时的机器。
快速开始 image-agent-plus generate \ --prompt "一只橘猫坐在雨天窗台上,电影感光线" \ --aspect-ratio "16:9"
常用命令 image-agent-plus check # 默认:有密钥走 image2 image-agent-plus generate \ --prompt "AI 时代,我们应该沉淀下来的是什么,中文社论海报" \ --aspect-ratio "16:9" # 无密钥 fallback 到 Codex CLI image-agent-plus generate \ --prompt "AI 时代,我们应该沉淀下来的是什么,中文社论海报" \ --provider codex \ --aspect-ratio "16:9"
Codex 生成后收集 Codex 显示 Generated Image 并保存至 ~/.codex/generated_images 后,执行: image-agent-plus collect-codex
选项 --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 指定模型;Codex CLI 默认生成勿传 --output-count 1-8 张图
Codex 收集示例 image-agent-plus collect-codex --filename ~/Desktop/output.png 省略 --filename 时,默认复制到 ~/Desktop/image-agent-plus-output/
环境 优先本地运行时。image2 直连 API 模式,请先在 shell 或 agent 密钥管理器配置 OpenAI 密钥。 CLI 仍兼容旧 NANOBANANA_ 变量作为回读。