OpenClaw Nano Banana Pro API 統合チュートリアル：3つの設定ステップ + 5つの推奨スキル

OpenClaw と Nano Banana Pro の連携：最強のオープンソースAIエージェントと最強の画像生成モデルの出会い

OpenClaw は現在 GitHub で最も注目されているオープンソースAIエージェントプラットフォーム（25万+ Stars）であり、Nano Banana Pro は Google DeepMind が発表したフラッグシップ画像生成モデルです。これらを組み合わせることで、WhatsApp、Telegram、Slack など 12 以上のプラットフォームから、スタジオ級のAI画像生成能力をいつでも呼び出すことが可能になります。さらに、APIYI を利用すれば、NB Pro の 1K から 4K まで全解像度が $0.05/回 の均一価格で利用でき、公式サイトの 20% オフに相当します。

コアバリュー: 本記事を読み終えることで、OpenClaw と NB Pro の連携設定が完了し、コードでの呼び出し方法を習得できます。さらに、画像生成効率を大幅に向上させる 5 つの OpenClaw スキルについても理解を深めることができます。

OpenClaw プラットフォーム概要：なぜ Nano Banana Pro の連携に最適なのか

設定を行う前に、OpenClaw のコア機能と、なぜ NB Pro 連携に理想的なプラットフォームなのかを簡単に見ていきましょう。

OpenClaw コア情報概要

OpenClaw のユニークな点は「Heartbeat」メカニズムです。AI は Cron タスクや Webhook を通じて自身を主动的に起動できるため、ユーザーからのメッセージ送信を待つ必要がありません。これにより、「毎朝 9 時にその日のマーケティング素材を自動生成する」といった自動化ワークフローを設定でき、NB Pro の画像生成能力と組み合わせることで、真の無人AIクリエイティブを実現します。

🚀 クイック体験: まだ OpenClaw をインストールしていない場合は、まず imagen.apiyi.com で NB Pro の画像生成効果をオンラインで体験し、連携するかどうかを決定することをお勧めします。APIYI は無料テスト枠を提供しており、設定不要で画像生成が可能です。

OpenClaw インストール

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

# または npm を使用
npm install -g @openclaw/openclaw

インストール後、openclaw コマンドを実行して設定ウィザードを起動します。

OpenClaw で Nano Banana Pro API を設定する方法：3 ステップで完了

OpenClaw への統合は非常にシンプルです。APIYI をカスタムモデルプロバイダーとして登録し、Nano Banana Pro モデルを設定します。APIYI は Google の公式 API 形式に完全互換しているため、リクエスト URL と API キーを置き換えるだけで利用できます。

ステップ 1：APIYI キーの取得

1. APIYI 公式サイト apiyi.com にアクセスしてアカウントを登録します。
2. コンソールに移動し、新しい API キーを作成します。
3. モデルリストで Nano Banana Pro (gemini-3-pro-image-preview) が有効になっていることを確認します。

ステップ 2：OpenClaw 設定ファイルの編集

OpenClaw の設定ファイル ~/.openclaw/openclaw.json を開き、APIYI をカスタムプロバイダーとして追加します。

{
  "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 フィールドは openai-completions ではなく、必ず google-generative-ai に設定してください。NB Pro は Google ネイティブの generateContent エンドポイント形式を使用しており、APIYI はこの形式に完全互換しています。OpenAI 互換モードを使用すると、画像生成機能は正常に動作しません。

Nano Banana Pro API コード呼び出し：公式フォーマットを直接利用

APIYI は Google 公式ドキュメントの呼び出しフォーマットに完全互換しています。Google 公式 API を既に利用している場合は、以下の 2 つの変更のみが必要です。

1. リクエスト URL の置換: generativelanguage.googleapis.com を api.apiyi.com に変更します。
2. API キーの置換: APIYI が提供するキーを使用します。

Nano Banana Pro コード呼び出し例（Python）

import google.generativeai as genai

# APIYI エンドポイントを設定 — URL と 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");

// APIYI エンドポイントを設定
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 全解像度パラメータ説明

🎯 コストメリット: APIYI では、NB Pro の 1K から 4K までの全解像度が $0.05/回 の均一料金です。これは、4K（4096×4096）の超高解像度画像を生成するコストが 1K と同じであることを意味します。最高の画質を得るために、迷わず 4K を選択してください。

OpenClaw Nano Banana Pro 出图测试と検証

設定が完了したら、OpenClaw から直接メッセージを送信して、出図効果をテストできます。

OpenClaw でのテスト

接続済みの任意のメッセージプラットフォーム（Telegram、WhatsApp など）で直接送信してください。

サングラスをかけた柴犬がビーチでサーフィンしている画像を生成してください。晴天で、カートゥーンスタイルでお願いします。

OpenClaw は自動的に設定された NB Pro モデルを呼び出し、画像を生成して会話に返信します。

オンライン出図テスト

OpenClaw を設定する前に NB Pro の出図品質をテストしたい場合は、APIYI が提供するオンラインテストツールを使用できます。

• 出図テストアドレス: imagen.apiyi.com
• コードを書く必要がなく、オンラインでプロンプトを入力するだけで出図できます。
• すべての解像度とアスペクト比のパラメータをサポートしています。
• プロンプトの効果を迅速に検証するのに適しています。

コード例のダウンロード

APIYI は、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/回）に切り替えて、最高の画質を取得してください。APIYI プラットフォームでは、モデル ID を変更するだけで、他のコードを変更する必要はありません。

OpenClaw スキル推奨：Nano Banana Pro の画像生成効率を向上させる 5 つのスキル

OpenClaw の強みはそのスキルエコシステムにあります。ClawHub には 5,490 以上のコミュニティスキルがあり、その中でも画像生成に最も関連性の高い 5 つのスキルをご紹介します。

スキル 1：Image Generator（画像生成アシスタント）

このスキルの核となる価値はプロンプトの最適化にあります。「猫の絵を描いて」と言うだけで、スタイル、光と影、構図の詳細を含む専門的なプロンプトに自動拡張され、NB Pro の画像生成品質が大幅に向上します。

スキル 2：Batch Image Creator（バッチ画像クリエーター）

一度に複数の画像を生成する必要があるシーンに適しています。例えば、Eコマースの製品画像やソーシャルメディアの週次コンテンツカレンダーなどです。このスキルは以下のことが可能です。

• 1 つのテーマに基づいて、異なる角度やスタイルの画像を複数バッチ生成する。
• 生成キューを自動管理し、レート制限のトリガーを回避する。
• テンプレート化されたプロンプトをサポートし、主要な変数を置き換えるだけでバッチ生成が可能。

スキル 3：Image Editor（画像エディター）

NB Pro は画像の生成だけでなく、参照画像に基づいた編集もサポートしています。このスキルは画像編集のワークフローをカプセル化しています。

• 元画像 + テキストによる変更要求をアップロードする。
• 部分的な変更をサポート（背景の変更、色の変更、要素の追加）。
• 画像フォーマットの変換と Base64 エンコーディングを自動処理する。

スキル 4：Social Media Poster（ソーシャルメディアポスター）

ソーシャルメディア向けに特化した画像生成スキルです。

• Instagram、Twitter、小紅書などのプラットフォームに最適なサイズテンプレートを内蔵。
• テキスト付きのポスターを自動生成（NB Pro の優れたテキストレンダリング能力を活用）。
• ブランドカラーとスタイルの整合性を設定可能。

スキル 5：Heartbeat Image Scheduler（定时出图）

OpenClaw 独自の Heartbeat メカニズムを利用して、定期的な自動画像生成を実現します。

• Cron 式を設定して、定期的に画像生成をトリガーする。
• 例：「毎日 8 時に、おはようの挨拶画像を生成する」。
• 生成された画像は指定されたメッセージプラットフォームに自動送信される。
• 運用チームのコンテンツ制作自動化に適している。

スキルのインストール方法

OpenClaw でスキルをインストールするのは非常に簡単です。

# ClawHub からインストール
openclaw skill install image-generator

# または、メッセージで AI に直接インストールさせる
# 送信: "image-generator スキルをインストールして"

ClawHub のウェブサイトで完全なスキルカタログを閲覧することもできます: clawhub.openclaw.ai

🎯 ベストプラクティス: まず Image Generator スキルをインストールすることをお勧めします。これにより、プロンプトが自動的に最適化され、NB Pro の画像生成品質が大幅に向上します。APIYI apiyi.com の低コストの利点を組み合わせることで、安心して複数回イテレーションを行い、最も満足のいく結果を迅速に見つけることができます。

Nano Banana Pro vs NB2：OpenClaw での選択方法

APIYI は NB Pro と NB2 の両方のモデルをサポートしており、OpenClaw の設定には両方追加されています。シナリオに応じて適切なモデルを選択してください。

OpenClaw でモデルを切り替えるには、メッセージコマンドを変更するだけです。

# NB Pro を使用して画像生成
NB Pro を使って製品プロモーション画像を生成してください

# NB2 に切り替えて高速画像生成
NB2 を使って 5 つの異なるスタイルのロゴ案を高速生成してください

または、設定ファイルでデフォルトモデルを一時的に切り替えることもできます。

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

よくある質問

まとめ：OpenClaw + Nano Banana Pro 接続の主要ポイント

OpenClaw を Nano Banana Pro に接続するための主要ステップ：

1. APIキーの取得: APIYI apiyi.com で登録し、APIキーを取得します。
2. 設定ファイルの編集: ~/.openclaw/openclaw.json で APIYI プロバイダーを追加し、api を google-generative-ai に設定します。
3. モデルの選択: NB Pro（$0.05/回、最高画質）または NB2（$0.035/回、速度優先）を選択します。
4. スキルのインストール: ClawHub を通じて Image Generator などのスキルをインストールして効率を高めます。
5. 画像生成の開始: 任意のメッセージプラットフォームで自然言語の説明を送信して画像を生成します。

Nano Banana Pro は APIYI の日次消費量第一位の主力モデルであり、プラットフォームは安定性維持のために大量の運用リソースを投入しています。公式直転送、速度制限なし、商用利用可能を保証します。1K から 4K の全解像度で統一価格 $0.05/回、公式サイトの同等サービスは $0.234/回で、わずか約2割引です。

APIYI apiyi.com を通じて Nano Banana Pro に接続し、OpenClaw のスキルエコシステムと組み合わせることで、効率的なAI画像生成ワークフローを構築することをお勧めします。

テクニカルサポート: APIYI apiyi.com —— 安定・信頼性の高いAI大規模言語モデルAPI中継プラットフォーム、NB Pro 全シリーズ 2割引から