Nano Banana Pro 图像生成

使用 OpenRouter 的 Nano Banana Pro（Gemini 3 Pro 图像预览）生成新图像。

使用方法

请使用绝对路径运行脚本（请勿先切换到技能目录）：

生成新图像：

sh ~/.openclaw/workspace/skills/nano-banana-pro-openrouter/scripts/generate_image.sh --prompt "your image description" [--filename "output-name.png" | --filename auto] [--resolution 1K|2K|4K] [--api-key KEY]

注意：当前 shell 版本仅支持生成新图像（不支持输入图像编辑）。

重要提示：

• 图像始终保存在~/.openclaw/workspace/outputs/nano-banana-pro-openrouter
• 如果--filename参数包含路径，则仅使用其基本文件名

默认工作流程（草稿 -> 迭代 -> 最终版）

目标：快速迭代，在提示词正确前不浪费时间生成 4K 图像。

• 草稿（1K）：快速反馈循环
  • sh ~/.openclaw/workspace/skills/nano-banana-pro-openrouter/scripts/generate_image.sh --prompt "<草稿提示词>" --filename auto --resolution 1K
• 迭代：小幅调整提示词；每次运行使用新的文件名
• 最终版（4K）：仅在提示词确定后生成
  • sh ~/.openclaw/workspace/skills/nano-banana-pro-openrouter/scripts/generate_image.sh --prompt "<final prompt>" --filename auto --resolution 4K

分辨率选项

Gemini 3 Pro Image API 支持三种分辨率（K 必须大写）：

• 1K（默认）- 约 1024 像素分辨率
• 2K - 约 2048 像素分辨率
• 4K - 约 4096 像素分辨率

将用户请求映射到 API 参数：

• 未提及分辨率 -> 1K
• "低分辨率"、"1080"、"1080p"、"1K" -> 1K
• "2K"、"2048"、"正常"、"中等分辨率" -> 2K
• "高分辨率"、"high-res"、"hi-res"、"4K"、"ultra" -> 4K

API 密钥与基础 URL

脚本按以下顺序检查 API 密钥：

1. --api-key 参数（如果用户在聊天中提供了密钥则使用）
2. OPENROUTER_API_KEY 环境变量

API 基础 URL 必须通过 OPENROUTER_BASE_URL 设置。请使用完整的聊天完成端点（对于 OpenRouter：https://openrouter.ai/api/v1/chat/completions）。

脚本还会自动加载.env文件（如果存在）：

• 当前工作目录中的.env文件
• 技能目录中的.env文件

重要提示：如果存在.env文件，不要一开始就询问用户密钥。 直接运行脚本，只有在出现"未提供API密钥"错误时才询问。

OpenClaw聊天执行规则

• OpenClaw不会自动加载技能目录的.env文件
• 如果~/.openclaw/workspace/skills/nano-banana-pro-openrouter/.env存在：
  1. 使用读取工具来读取.env文件
  2. 提取OPENROUTER_API_KEY和OPENROUTER_BASE_URL
  3. 运行脚本时始终通过--api-key传递密钥
• 只有在.env文件缺失或无法读取密钥时才询问用户
• 如果用户要求使用带时间戳的文件名，优先采用--filename auto（不要手写日期）

如果两者都不可用，脚本将退出并显示错误信息。

预检与常见故障（快速修复）

预检：

• command -v sh（必须存在）
• command -v curl（必须存在）
• command -v base64（必须存在）

常见故障：

• 错误：未提供 API 密钥。-> 读取 .env 文件并用 --api-key 重试；若仍失败，请用户设置 OPENROUTER_API_KEY
• 错误：未提供 API 基础 URL。-> 确保 OPENROUTER_BASE_URL 设置为完整的聊天补全端点
• 加载输入图像时出错：-> 路径错误或文件不可读；请确认 --input-image 指向真实的图像文件
• "配额/权限/403" 类 API 错误 -> 密钥错误、无访问权限或配额已用完；请尝试使用其他密钥/账户

文件名生成

请按照以下模式生成文件名：yyyy-mm-dd-hh-mm-ss-名称.png

格式：{时间戳}-{描述性名称}.png

• 时间戳：当前日期/时间，格式为yyyy-mm-dd-hh-mm-ss（24小时制）
• 名称：描述性小写文本，使用连字符连接
• 描述部分请保持简洁（通常为1-5个词）
• 请根据用户的提示或对话上下文来生成
• 如果上下文不明确，请使用image

示例：

• 提示 "A serene Japanese garden" ->2025-11-23-14-23-05-japanese-garden.png
• 提示 "sunset over mountains" ->2025-11-23-15-30-12-sunset-mountains.png
• 提示 "create an image of a robot" ->2025-11-23-16-45-33-robot.png
• 上下文不明确 ->2025-11-23-17-12-48-image.png

提示：为避免时间戳错误，请传递--filename auto并让脚本 使用系统时钟生成文件名。

图像编辑（Shell 版本不支持）

此 Shell 脚本仅支持生成新图像。当前版本不支持编辑输入图像。

提示词处理

对于生成任务：将用户的图像描述按原样传递给 --prompt 参数。仅在描述明显不足时才进行改写。

提示词模板（高命中率）

当用户描述模糊或需要精确编辑时，请使用模板。

生成模板：

• "创建一张图像，内容为：<主题>。风格：<风格>。构图：<相机/镜头>。光照：<光照>。背景：<背景>。调色板："<palette>。避免：<list>。”

输出

• 将PNG保存到~/.openclaw/workspace/outputs/nano-banana-pro-openrouter
• 如果--filename包含路径，则仅使用基本文件名
• 脚本输出生成图像文件的完整路径
• 脚本同时输出MEDIA_URL=file:///absolute/path用于每张图像

在回复中显示图像

• 使用MEDIA_URL值在模型响应中附加图像
• 在OpenClaw中，优先发送一条消息，其mediaUrl设置为该file:// URL
• 同时，在文本中包含文件路径以供参考

示例

生成新图像：

sh ~/.openclaw/workspace/skills/nano-banana-pro-openrouter/scripts/generate_image.sh --prompt "A serene Japanese garden with cherry blossoms" --filename auto --resolution 4K