OpenClaw Nano Banana Pro API 연동 완벽 가이드: 3단계 설정 + 추천 스킬 5가지

OpenClaw와 Nano Banana Pro 연동: 최강 오픈소스 AI 에이전트와 최강 이미지 생성 모델의 만남

OpenClaw는 현재 GitHub에서 가장 인기 있는 오픈소스 AI 에이전트 플랫폼(25만+ 스타)이며, Nano Banana Pro는 Google DeepMind에서 출시한 플래그십 이미지 생성 모델입니다. 이 둘을 결합하면 WhatsApp, Telegram, Slack 등 12개 이상의 플랫폼에서 언제든지 스튜디오급 AI 이미지 생성 능력을 호출할 수 있습니다. 또한 APIYI를 통해 NB Pro 1K부터 4K까지 모든 해상도를 단 $0.05/회로 이용할 수 있어, 공식 홈페이지 가격의 20% 수준입니다.

핵심 가치: 이 글을 읽고 나면 OpenClaw와 NB Pro 연동 설정을 완료하고, 코드 호출 방법을 익히며, 이미지 생성 효율을 크게 높여줄 5가지 OpenClaw 스킬에 대해 알게 될 것입니다.

OpenClaw 플랫폼 소개: 왜 OpenClaw를 NB 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 형식과 완벽하게 호환되므로, 요청 주소와 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를 사용 중이라면, 두 단계만 수정하면 됩니다.

1. 요청 주소 변경: generativelanguage.googleapis.com을 api.apiyi.com으로 변경하세요.
2. API 키 변경: APIYI에서 제공하는 키로 교체하세요.

Nano Banana Pro 코드 호출 예시 (Python)

import google.generativeai as genai

# APIYI 엔드포인트 설정 - 주소와 키만 변경하면 됩니다.
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 (배치 이미지 생성기)

한 번에 여러 장의 이미지를 생성해야 하는 경우에 적합합니다. 예를 들어, 이커머스 제품 이미지, 소셜 미디어 주간 콘텐츠 캘린더 등에 활용할 수 있습니다. 이 스킬은 다음과 같은 기능을 제공합니다.

• 하나의 주제에 따라 다양한 각도/스타일의 이미지를 배치로 생성합니다.
• 생성 큐를 자동으로 관리하여 속도 제한에 걸리는 것을 방지합니다.
• 템플릿화된 프롬프트를 지원하여 핵심 변수만 변경하면 배치로 이미지를 생성할 수 있습니다.

스킬 3: Image Editor (이미지 편집기)

NB Pro는 이미지를 생성할 뿐만 아니라 참조 이미지를 기반으로 한 편집도 지원합니다. 이 스킬은 이미지 편집 워크플로우를 캡슐화합니다.

• 원본 이미지 + 텍스트 설명으로 수정 요구사항을 업로드합니다.
• 부분 수정(배경 변경, 색상 변경, 요소 추가)을 지원합니다.
• 이미지 형식 변환 및 Base64 인코딩을 자동으로 처리합니다.

스킬 4: Social Media Poster (소셜 미디어 포스터)

소셜 미디어에 최적화된 이미지 생성 스킬입니다.

• Instagram, Twitter, Xiaohongshu 등 플랫폼에 맞는 최적의 크기 템플릿을 내장하고 있습니다.
• 텍스트가 포함된 포스터를 자동으로 생성합니다 (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. Skills 설치: ClawHub를 통해 Image Generator 등 Skills를 설치하여 효율성을 높이세요.
5. 이미지 생성 시작: 모든 메시지 플랫폼에서 자연어 설명을 보내 이미지를 생성하세요.

Nano Banana Pro는 APIYI에서 일일 소비량 1위를 차지하는 주력 모델로, 플랫폼은 안정성 확보를 위해 막대한 운영 자원을 투입했습니다. 공식 직접 전달, 속도 제한 없음, 상업적 이용 가능을 보장합니다. 1K부터 4K까지 모든 해상도에 대해 일괄 $0.05/회로 가격이 책정되었으며, 공식 홈페이지의 동일 서비스 가격 $0.234/회 대비 약 20% 수준입니다.

효율적인 AI 이미지 생성 워크플로우를 구축하기 위해 APIYI apiyi.com을 통해 Nano Banana Pro에 연동하고 OpenClaw의 Skills 생태계와 함께 활용하는 것을 추천합니다.

기술 지원: APIYI apiyi.com — 안정적이고 신뢰할 수 있는 AI 대규모 언어 모델 API 중계 플랫폼, NB Pro 전체 시리즈 20% 할인 시작