OpenClaw: полное руководство по интеграции с Nano Banana Pro API: 3 шага настройки + 5 рекомендуемых навыков

OpenClaw и Nano Banana Pro: мощнейший опенсорсный AI-агент встречается с лучшей моделью генерации изображений

OpenClaw — самая популярная опенсорсная платформа AI-агентов на GitHub (более 250 тыс. звезд), а Nano Banana Pro — флагманская модель генерации изображений от Google DeepMind. Их объединение означает, что вы сможете вызывать AI-генерацию изображений студийного качества на таких платформах, как WhatsApp, Telegram, Slack и других (более 12), и все это через APIYI. NB Pro поддерживает разрешение от 1K до 4K по единой цене — всего $0.05 за вызов, что составляет 20% от стоимости на официальном сайте.

Ключевая ценность: Прочитав эту статью, вы настроите интеграцию OpenClaw и NB Pro, освоите вызов модели через код и узнаете о 5 полезных "навыках" (Skills) OpenClaw, которые значительно повысят эффективность генерации изображений.

Знакомство с платформой OpenClaw: почему именно она идеально подходит для интеграции с Nano Banana Pro

Прежде чем приступить к настройке, давайте быстро разберемся в основных возможностях OpenClaw и поймем, почему эта платформа так хорошо подходит для интеграции с NB Pro.

Краткий обзор ключевой информации об OpenClaw

Уникальная особенность OpenClaw — механизм "Heartbeat". AI может самостоятельно активироваться через Cron-задачи и Webhook, без необходимости вашего сообщения для запуска. Это позволяет создавать автоматизированные рабочие процессы, например: "Каждое утро в 9:00 автоматически генерировать маркетинговые материалы на день". В сочетании с возможностями генерации изображений NB Pro это открывает путь к полностью автономному AI-творчеству.

🚀 Быстрый тест: Если вы еще не установили OpenClaw, можете сначала попробовать NB Pro онлайн на imagen.apiyi.com, чтобы оценить качество генерации изображений, прежде чем принимать решение об интеграции. APIYI предоставляет бесплатные тестовые лимиты, так что вы сможете генерировать изображения без предварительной настройки.

Установка OpenClaw

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

# Или через npm
npm install -g @openclaw/openclaw

После установки выполните команду openclaw, чтобы запустить мастер настройки.

OpenClaw: Настройка интеграции с Nano Banana Pro API за 3 шага

Основная идея интеграции проста: зарегистрируйте APIYI в OpenClaw как кастомного поставщика моделей, а затем настройте модель Nano Banana Pro. APIYI полностью совместим с форматом официального API Google, поэтому вам нужно только заменить адрес запроса и API-ключ.

Шаг 1: Получение API-ключа 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 должно быть установлено в google-generative-ai, а не openai-completions. NB Pro использует нативный конечный формат generateContent от Google, который APIYI полностью поддерживает. Если использовать режим совместимости с OpenAI, функция генерации изображений не будет работать корректно.

Вызовы кода API Nano Banana Pro: прямое использование в официальном формате

APIYI полностью совместим с форматом вызовов из официальной документации Google. Если вы уже используете официальный API Google, вам нужно внести всего два изменения:

1. Замените адрес запроса: измените generativelanguage.googleapis.com на api.apiyi.com.
2. Замените API-ключ: используйте ключ, предоставленный APIYI.

Пример вызова кода Nano Banana Pro (Python)

import google.generativeai as genai

# Настройка конечной точки APIYI — просто замените адрес и 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 для полного разрешения

🎯 Преимущество по стоимости: NB Pro на APIYI имеет единую цену $0.05 за запрос для всех разрешений от 1K до 4K. Это означает, что создание сверхчеткого изображения 4K (4096×4096) стоит столько же, сколько и изображение 1K. Просто выберите 4K для получения наилучшего качества изображения.

Тестирование и проверка генерации изображений OpenClaw Nano Banana Pro

После настройки вы можете отправлять сообщения прямо в OpenClaw для тестирования генерации изображений.

Тестирование в OpenClaw

Отправьте сообщение в любую подключенную платформу обмена сообщениями (Telegram, WhatsApp и т. д.):

Сгенерируй мне картинку: сиба-ину в солнцезащитных очках, катающуюся на серфе по пляжу, солнечно, в мультяшном стиле

OpenClaw автоматически вызовет настроенную модель NB Pro, сгенерирует изображение и отправит его в чат.

Онлайн-тестирование генерации изображений

Если вы хотите сначала протестировать качество генерации изображений NB Pro перед настройкой OpenClaw, вы можете использовать онлайн-инструмент тестирования от 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 для переключения между двумя моделями достаточно изменить идентификатор модели, не меняя остальной код.

OpenClaw Skills: 5 инструментов для ускорения генерации изображений с Nano Banana Pro

OpenClaw силен своей экосистемой навыков (Skills). На ClawHub их более 5490, но вот 5 самых полезных для генерации изображений:

Skill 1: Image Generator (Помощник по генерации изображений)

Главная ценность этого Skill — оптимизация промптов. Просто скажите «Нарисуй мне кота», и он автоматически превратит это в профессиональный промпт с деталями стиля, освещения и композиции, значительно улучшая качество изображений, генерируемых NB Pro.

Skill 2: Batch Image Creator (Генератор пакетных изображений)

Идеально подходит для сценариев, где нужно сгенерировать несколько изображений за раз, например, для карточек товаров в e-commerce или контент-плана соцсетей на неделю. Этот Skill умеет:

• Генерировать множество изображений на одну тему под разными углами/в разных стилях.
• Автоматически управлять очередью генерации, чтобы избежать ограничений скорости.
• Поддерживать шаблонные промпты, позволяя легко генерировать пакеты изображений, просто меняя ключевые переменные.

Skill 3: Image Editor (Редактор изображений)

NB Pro не только генерирует изображения, но и позволяет редактировать их на основе эталонных. Этот Skill инкапсулирует рабочий процесс редактирования изображений:

• Загрузка исходного изображения + текстовое описание изменений.
• Поддержка локальных изменений (смена фона, цвета, добавление элементов).
• Автоматическая обработка конвертации форматов изображений и кодирования в Base64.

Skill 4: Social Media Poster (Постер для соцсетей)

Специализированный Skill для генерации изображений под социальные сети:

• Встроенные шаблоны оптимальных размеров для Instagram, Twitter, Xiaohongshu и других платформ.
• Автоматическая генерация постеров с текстом (используя отличные возможности рендеринга текста NB Pro).
• Поддержка настройки фирменных цветов и стилей для сохранения единообразия.

Skill 5: Heartbeat Image Scheduler (Планировщик изображений по расписанию)

Использует уникальный механизм Heartbeat от OpenClaw для автоматической генерации изображений по расписанию:

• Настройка Cron-выражения для запуска генерации изображений в определенное время.
• Например, «Каждое утро в 8:00 генерировать изображение с пожеланием доброго утра».
• Сгенерированные изображения автоматически отправляются на указанную платформу обмена сообщениями.
• Идеально подходит для автоматизации производства контента командами операционного управления.

Как установить Skills

Установка Skills в OpenClaw очень проста:

# Установка через ClawHub
openclaw skill install image-generator

# Или попросите AI установить прямо в чате
# Отправьте: "Установи навык image-generator"

Полный каталог Skills также доступен на сайте ClawHub: clawhub.openclaw.ai

🎯 Лучшая практика: Рекомендуем сначала установить Skill Image Generator. Он поможет автоматически оптимизировать промпты, что значительно повысит качество изображений, генерируемых NB Pro. В сочетании с низкими затратами APIYI apiyi.com, вы можете без опасений проводить множество итераций и быстро добиваться желаемого результата.

Nano Banana Pro vs NB2: Как выбрать в OpenClaw

APIYI поддерживает обе модели, NB Pro и NB2, и они уже добавлены в конфигурацию OpenClaw. Выбирайте подходящую модель в зависимости от сценария:

Переключение моделей в OpenClaw осуществляется изменением команды в сообщении:

# Генерация с NB Pro (по умолчанию)
Сгенерируй мне изображение для продвижения продукта с помощью NB Pro

# Переключение на быструю генерацию с NB2
Быстро сгенерируй 5 вариантов логотипа в разных стилях с помощью NB2

Или временно измените модель по умолчанию в файле конфигурации:

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

Частые вопросы

Ключевые моменты подключения OpenClaw к Nano Banana Pro

Основные шаги для подключения OpenClaw к Nano Banana Pro:

1. Получите ключ: Зарегистрируйтесь на APIYI apiyi.com и получите API-ключ.
2. Отредактируйте конфигурацию: Добавьте поставщика APIYI в ~/.openclaw/openclaw.json, установив api в google-generative-ai.
3. Выберите модель: NB Pro ($0.05 за запрос, максимальное качество) или NB2 ($0.035 за запрос, приоритет скорости).
4. Установите Skills: Установите Image Generator и другие навыки через ClawHub для повышения эффективности.
5. Начните генерацию: Отправляйте текстовые описания в любом мессенджере для создания изображений.

Nano Banana Pro — это основная модель с наибольшим дневным потреблением на APIYI. Платформа вложила значительные ресурсы в обеспечение ее стабильности — гарантируя прямую передачу данных от официального поставщика, отсутствие ограничений скорости и возможность коммерческого использования. Единая цена $0.05 за запрос для всех разрешений от 1K до 4K, в то время как на официальном сайте аналогичная услуга стоит $0.234, то есть всего около 20% от цены.

Рекомендуется подключаться к Nano Banana Pro через APIYI apiyi.com и использовать экосистему Skills OpenClaw для построения эффективных рабочих процессов генерации изображений с помощью ИИ.

Техническая поддержка: APIYI apiyi.com — надежная и стабильная платформа для переадресации API больших языковых моделей, NB Pro и вся линейка моделей со скидкой от 20%