OpenClaw 接入 Nano Banana Pro API 完整教程：3步配置 + 5个推荐 Skills

OpenClaw 接入 Nano Banana Pro：最强开源 AI 代理遇上最强图像生成

OpenClaw 是当前 GitHub 上最火的开源 AI 代理平台（25 万+ Stars），而 Nano Banana Pro 是 Google DeepMind 推出的旗舰级图像生成模型。将两者结合，意味着你可以在 WhatsApp、Telegram、Slack 等 12+ 平台上随时调用 Studio 级 AI 图像生成能力——而且通过 API易，NB Pro 1K 到 4K 全分辨率同价仅 $0.05/次，相当于官网 2 折。

核心价值: 读完本文，你将完成 OpenClaw + NB Pro 的接入配置，掌握代码调用方法，并了解 5 个能大幅提升出图效率的 OpenClaw Skills。

OpenClaw 平台简介：为什么选择它接入 Nano Banana Pro

在配置之前，先快速了解 OpenClaw 的核心能力，以及它为什么是接入 NB Pro 的理想平台。

OpenClaw 核心信息速览

OpenClaw 的独特之处在于「Heartbeat」机制——AI 可以通过 Cron 任务和 Webhook 主动唤醒自己，不需要你发消息触发。这意味着你可以设定「每天早上 9 点自动生成今日营销素材」这样的自动化工作流，搭配 NB Pro 的图像生成能力，真正实现无人值守的 AI 创作。

🚀 快速体验: 如果你还没有安装 OpenClaw，可以先在 imagen.apiyi.com 在线体验 NB Pro 出图效果，再决定是否接入。API易 提供免费测试额度，无需配置即可出图。

OpenClaw 安装

# macOS / Linux
curl -fsSL https://get.openclaw.ai | bash

# 或使用 npm
npm install -g @openclaw/openclaw

安装完成后，运行 openclaw 命令启动配置向导。

OpenClaw 接入 Nano Banana Pro API：3 步完成配置

接入的核心思路很简单：在 OpenClaw 中注册 API易 作为自定义模型提供商，然后配置 Nano Banana Pro 模型。API易 完全兼容 Google 官方 API 格式，只需替换请求地址和密钥。

第 1 步：获取 API易 密钥

1. 访问 API易 官网 apiyi.com 注册账号
2. 进入控制台，创建新的 API Key
3. 在模型列表中确认已开通 Nano Banana Pro（gemini-3-pro-image-preview）

第 2 步：编辑 OpenClaw 配置文件

打开 OpenClaw 的配置文件 ~/.openclaw/openclaw.json，添加 API易 作为自定义提供商：

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "your-apiyi-key",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "gemini-3-pro-image-preview",
            "name": "Nano Banana Pro"
          },
          {
            "id": "gemini-3.1-flash-image-preview",
            "name": "Nano Banana 2"
          }
        ]
      }
    }
  }
}

第 3 步：设置默认图像生成模型

在同一配置文件中，指定 NB Pro 为默认图像生成模型：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/gemini-3-pro-image-preview"
      }
    }
  }
}

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/gemini-3-pro-image-preview"
      }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-your-apiyi-key-here",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "gemini-3-pro-image-preview",
            "name": "Nano Banana Pro",
            "contextWindow": 65536,
            "cost": {
              "input": 0.25,
              "output": 60.0
            }
          },
          {
            "id": "gemini-3.1-flash-image-preview",
            "name": "Nano Banana 2",
            "contextWindow": 131072,
            "cost": {
              "input": 0.125,
              "output": 30.0
            }
          }
        ]
      }
    }
  }
}

配置完成后，重启 OpenClaw 即可生效。

OpenClaw 接入 NB Pro 配置要点

💡 重要提示: api 字段必须设置为 google-generative-ai 而非 openai-completions。NB Pro 使用 Google 原生的 generateContent 端点格式，API易 完全兼容此格式。如果使用 OpenAI 兼容模式，图像生成功能将无法正常工作。

Nano Banana Pro API 代码调用：官方格式直接使用

API易 完全兼容 Google 官方文档的调用格式。如果你已经在用 Google 官方 API，只需要两步修改：

1. 替换请求地址: 将 generativelanguage.googleapis.com 改为 api.apiyi.com
2. 替换 API Key: 使用 API易 提供的密钥

Nano Banana Pro 代码调用示例（Python）

import google.generativeai as genai

# 配置 API易 端点 —— 只需替换地址和密钥
genai.configure(
    api_key="your-apiyi-key",
    client_options={"api_endpoint": "api.apiyi.com"}
)

model = genai.GenerativeModel("gemini-3-pro-image-preview")

response = model.generate_content(
    "一只橘猫坐在窗台上看雨，日系动漫风格，温暖的室内灯光",
    generation_config=genai.GenerationConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config={"image_size": "2K", "aspect_ratio": "16:9"}
    )
)

# 提取生成的图片
for part in response.candidates[0].content.parts:
    if hasattr(part, "inline_data"):
        with open("output.png", "wb") as f:
            f.write(part.inline_data.data)
        print("图片已保存: output.png")
    elif hasattr(part, "text"):
        print(f"描述: {part.text}")

curl -X POST "https://api.apiyi.com/v1/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: your-apiyi-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "生成一张赛博朋克风格的城市夜景，霓虹灯倒映在湿漉漉的街道上"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "imageSize": "4K",
        "aspectRatio": "21:9"
      }
    }
  }'

const { GoogleGenerativeAI } = require("@google/generative-ai");
const fs = require("fs");

// 配置 API易 端点
const genAI = new GoogleGenerativeAI("your-apiyi-key", {
  baseUrl: "https://api.apiyi.com/v1"
});

const model = genAI.getGenerativeModel({
  model: "gemini-3-pro-image-preview"
});

async function generateImage() {
  const result = await model.generateContent({
    contents: [{
      role: "user",
      parts: [{ text: "一幅水墨画风格的中国山水，远山近水，留白意境" }]
    }],
    generationConfig: {
      responseModalities: ["TEXT", "IMAGE"],
      imageConfig: { imageSize: "4K", aspectRatio: "3:2" }
    }
  });

  const response = result.response;
  for (const part of response.candidates[0].content.parts) {
    if (part.inlineData) {
      const imageBuffer = Buffer.from(part.inlineData.data, "base64");
      fs.writeFileSync("output.png", imageBuffer);
      console.log("图片已保存: output.png");
    }
  }
}

generateImage();

Nano Banana Pro 全分辨率参数说明

🎯 成本优势: NB Pro 在 API易 上 1K 到 4K 全分辨率统一定价 $0.05/次。这意味着生成一张 4K（4096×4096）超高清图片的成本与 1K 完全相同，直接选 4K 即可获得最佳画质。

OpenClaw Nano Banana Pro 出图测试与验证

配置完成后，你可以在 OpenClaw 中直接发送消息测试出图效果。

在 OpenClaw 中测试

直接在任意已连接的消息平台（Telegram、WhatsApp 等）中发送：

帮我生成一张图片：一只戴墨镜的柴犬在沙滩上冲浪，阳光明媚，卡通风格

OpenClaw 会自动调用配置的 NB Pro 模型，生成图片并回复到对话中。

在线出图测试

如果想先测试 NB Pro 的出图质量再配置 OpenClaw，可以使用 API易 提供的在线测试工具：

• 出图测试地址: imagen.apiyi.com
• 无需写代码，在线输入提示词即可出图
• 支持全部分辨率和宽高比参数
• 适合快速验证提示词效果

代码示例下载

API易 提供了完整的开发参考代码包，包含 Python、Node.js、cURL 等多种语言的调用示例：

• 示例代码下载: xinqikeji.feishu.cn/wiki/W4vEwdiCPi3VfTkrL5hcVlDxnQf
• Google 官方文档: ai.google.dev/gemini-api/docs/image-generation

💰 成本控制建议: 开发测试阶段建议使用 NB2（$0.035/次）节省成本，正式上线后切换到 NB Pro（$0.05/次）获取最佳画质。在 API易 平台上两个模型只需修改模型 ID，无需改动其他代码。

OpenClaw Skills 推荐：5 个提升 Nano Banana Pro 出图效率的技能

OpenClaw 的强大之处在于其技能生态。ClawHub 上有 5,490+ 社区技能，以下 5 个与图像生成最为相关：

Skill 1：Image Generator（图像生成助手）

这个 Skill 的核心价值在于提示词优化。你只需要说「帮我画一只猫」，它会自动扩展为包含风格、光影、构图细节的专业提示词，显著提升 NB Pro 的出图质量。

Skill 2：Batch Image Creator（批量图片生成器）

适合需要一次性生成多张图片的场景，比如电商产品图、社交媒体一周内容日历等。该 Skill 可以：

• 根据一个主题批量生成多张不同角度/风格的图片
• 自动管理生成队列，避免触发限流
• 支持模板化提示词，替换关键变量即可批量出图

Skill 3：Image Editor（图片编辑器）

NB Pro 不仅能生成图片，还支持基于参考图的编辑。这个 Skill 封装了图片编辑的工作流：

• 上传原图 + 文字描述修改需求
• 支持局部修改（换背景、改颜色、添加元素）
• 自动处理图片格式转换和 Base64 编码

Skill 4：Social Media Poster（社交媒体海报）

专门为社交媒体设计的出图 Skill：

• 内置 Instagram、Twitter、小红书等平台的最佳尺寸模板
• 自动生成带文字的海报（利用 NB Pro 优秀的文字渲染能力）
• 支持品牌色彩和风格一致性设定

Skill 5：Heartbeat Image Scheduler（定时出图）

利用 OpenClaw 独有的 Heartbeat 机制，实现定时自动出图：

• 设定 Cron 表达式，定时触发图片生成
• 比如「每天 8:00 生成一张早安问候图」
• 生成的图片自动发送到指定的消息平台
• 适合运营团队自动化内容生产

Skills 安装方法

在 OpenClaw 中安装 Skill 非常简单：

# 通过 ClawHub 安装
openclaw skill install image-generator

# 或在消息中直接让 AI 安装
# 发送: "安装 image-generator 技能"

也可以在 ClawHub 网站浏览完整的技能目录：clawhub.openclaw.ai

🎯 最佳实践: 推荐先安装 Image Generator Skill，它能帮你自动优化提示词，显著提升 NB Pro 的出图质量。配合 API易 apiyi.com 的低成本优势，可以放心多次迭代，快速找到最满意的效果。

Nano Banana Pro vs NB2：在 OpenClaw 中如何选择

API易 同时支持 NB Pro 和 NB2 两个模型，在 OpenClaw 配置中已经添加了两者。根据不同场景选择合适的模型：

在 OpenClaw 中切换模型只需修改消息指令：

# 使用 NB Pro 出图（默认）
用 NB Pro 帮我生成一张产品宣传图

# 切换到 NB2 快速出图
用 NB2 快速生成 5 张不同风格的 Logo 方案

或者在配置文件中临时切换默认模型：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/gemini-3.1-flash-image-preview"
      }
    }
  }
}

常见问题

总结：OpenClaw + Nano Banana Pro 接入核心要点

OpenClaw 接入 Nano Banana Pro 的核心步骤：

1. 获取密钥: 在 API易 apiyi.com 注册并获取 API Key
2. 编辑配置: 在 ~/.openclaw/openclaw.json 中添加 API易 提供商，设置 api 为 google-generative-ai
3. 选择模型: NB Pro（$0.05/次，最高画质）或 NB2（$0.035/次，速度优先）
4. 安装 Skills: 通过 ClawHub 安装 Image Generator 等技能提升效率
5. 开始出图: 在任意消息平台发送自然语言描述即可生成图片

Nano Banana Pro 是 API易 日消耗第一的主力模型，平台投入了大量运维资源维护其稳定性——确保官方直转、不限速、可商用。1K 到 4K 全分辨率统一定价 $0.05/次，官网同等服务 $0.234/次，仅需约 2 折。

推荐通过 API易 apiyi.com 接入 Nano Banana Pro，配合 OpenClaw 的 Skills 生态，构建高效的 AI 图像生成工作流。

技术支持: API易 apiyi.com —— 稳定可靠的 AI 大模型 API 中转平台，NB Pro 全系列 2 折起