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 最強開源 AI 代理 × 最強圖像生成模型

<！– 左側: OpenClaw –> 🦞 OpenClaw GitHub 250K+ Stars 12+ 消息平臺支持 5，490+ 社區 Skills Heartbeat 自動化 本地運行，數據安全

<！– 中間連接: 箭頭和標籤 –> API易 中轉

<！– 右側: Nano Banana Pro –> 🎨 Nano Banana Pro Google DeepMind 旗艦 Studio 級畫質 4K 超高清輸出 優秀中文文字渲染 10 種寬高比支持

<！– 底部三個亮點標籤 –> 3 步完成配置 修改 JSON 即可接入

官網 2 折價格 $0.05/次 全分辨率

1K-4K 同價 直選 4K 最佳畫質

<！– 底部品牌 –> 推薦 API易：穩定可靠的 AI 大模型 API 中轉站，價格便宜、免費試用

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 即可獲得最佳畫質。

<！– 背景 –>

<！– 標題 –> Nano Banana Pro 價格對比：API易 vs Google 官網 API易 NB Pro 全分辨率統一定價，低至官網 2 折

<！– 分隔線 –>

<！– 圖例 –> Google 官網 API易 NB2 API易

<！– Y軸標籤 –> $0.25 $0.15 $0.05 <！– 基線 –>

<！– === NB Pro 1K 對比 === –> <！– Google 官網 1K: $0.134 –> $0.134

<！– API易 1K: $0.05 –> $0.05

<！– 標籤 –> NB Pro 1K

<！– === NB Pro 2K 對比 === –> <！– Google 官網 2K: $0.18 –> $0.18

<！– API易 2K: $0.05 –> $0.05

<！– 標籤 –> NB Pro 2K

<！– === NB Pro 4K 對比 === –> <！– Google 官網 4K: $0.234 –> $0.234

<！– API易 4K: $0.05 –> $0.05

<！– 標籤 –> NB Pro 4K

<！– 折扣標籤 –> 低至 2 折！

<！– === NB2 API易 === –> <！– NB2 API易: $0.035 –> $0.035 NB2

<！– 核心賣點框 –> API易 核心優勢：NB Pro 1K-4K 全分辨率同價 $0.05/次 確保官方直轉 · 不限速 · 穩定可商用 · 日消耗第一主力模型

<！– 底部品牌 –> 推薦 API易：穩定可靠的 AI 大模型 API 中轉站，價格便宜、免費試用

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 → API易 → Google NB Pro 接入架構

<！– ===== 第一層: 消息平臺 ===== –> 消息平臺

💬 Telegram

📱 WhatsApp

💼 Slack

🎮 Discord

+ 8 更多平臺

<！– 箭頭: 平臺 → OpenClaw –>

<！– ===== 第二層: OpenClaw ===== –> 🦞 OpenClaw

📋 Skills 技能引擎 🔄 Heartbeat 自動化 🗂️ 本地文件管理 🌐 瀏覽器自動化 🎙️ 語音交互 openclaw.json 配置

<！– 箭頭: OpenClaw → API易 –> generateContent

<！– ===== 第三層: API易 ===== –> ⚡ API易 中轉

✅ 官方格式兼容 💰 2 折價格 $0.05/次 🚀 不限速，可商用 🔒 確保官方直轉 📊 日消耗 No.1 模型 api.apiyi.com/v1

<！– 箭頭: API易 → Google –> 官方 API

<！– ===== 第四層: Google NB Pro ===== –> 🎨 Google NB Pro

Gemini 3 Pro 架構 旗艦級畫質輸出 1K / 2K / 4K 分辨率 10 種寬高比 優秀文字渲染

<！– 底部說明 –> 只需替換請求地址和密鑰，完全兼容 Google 官方文檔格式

<！– 底部品牌 –> 推薦 API易：穩定可靠的 AI 大模型 API 中轉站，價格便宜、免費試用

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 折起