Google (Gemini)

• Постачальник: google
• Автентифікація: GEMINI_API_KEY або GOOGLE_API_KEY
• API: Google Gemini API
• Параметр середовища виконання: agentRuntime.id: "google-gemini-cli" повторно використовує OAuth Gemini CLI, зберігаючи канонічні посилання на моделі у вигляді google/*.

​

Початок роботи

openclaw onboard --auth-choice gemini-api-key

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice gemini-api-key \
  --gemini-api-key "$GEMINI_API_KEY"

{
  agents: {
    defaults: {
      model: { primary: "google/gemini-3.1-pro-preview" },
    },
  },
}

openclaw models list --provider google

# Homebrew
brew install gemini-cli

# або npm
npm install -g @google/gemini-cli

openclaw models auth login --provider google-gemini-cli --set-default

openclaw models list --provider google

​

Можливості

​

Вебпошук

{
  plugins: {
    entries: {
      google: {
        config: {
          webSearch: {
            apiKey: "AIza...", // необов’язково, якщо задано GEMINI_API_KEY або models.providers.google.apiKey
            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // у разі відсутності використовується models.providers.google.baseUrl
            model: "gemini-2.5-flash",
          },
        },
      },
    },
  },
}

​

Генерування зображень

• Також підтримується google/gemini-3-pro-image-preview
• Генерування: до 4 зображень на запит
• Режим редагування: увімкнено, до 5 вхідних зображень
• Параметри геометрії: size, aspectRatio і resolution

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "google/gemini-3.1-flash-image-preview",
      },
    },
  },
}

​

Генерування відео

• Модель відео за замовчуванням: google/veo-3.1-fast-generate-preview
• Режими: перетворення тексту на відео, зображення на відео та процеси з одним еталонним відео
• Підтримуються aspectRatio (16:9, 9:16) і resolution (720P, 1080P); наразі Veo не підтримує виведення аудіо
• Підтримувана тривалість: 4, 6 або 8 секунд (інші значення округлюються до найближчого дозволеного значення)

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "google/veo-3.1-fast-generate-preview",
      },
    },
  },
}

​

Генерування музики

• Модель музики за замовчуванням: google/lyria-3-clip-preview
• Також підтримується google/lyria-3-pro-preview
• Керування запитом: lyrics і instrumental
• Формат виведення: за замовчуванням mp3, а також wav у google/lyria-3-pro-preview
• Еталонні вхідні дані: до 10 зображень
• Запуски на основі сеансу від’єднуються через спільний процес завдань і станів, зокрема action: "status"

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "google/lyria-3-clip-preview",
      },
    },
  },
}

​

Перетворення тексту на мовлення

• Голос за замовчуванням: Kore
• Автентифікація: messages.tts.providers.google.apiKey, models.providers.google.apiKey, GEMINI_API_KEY або GOOGLE_API_KEY
• Виведення: WAV для звичайних вкладень TTS, Opus для цільових голосових повідомлень, PCM для Talk/телефонії
• Виведення голосових повідомлень: PCM від Google обгортається у WAV і транскодується в Opus із частотою 48 кГц за допомогою ffmpeg

{
  messages: {
    tts: {
      auto: "always",
      provider: "google",
      providers: {
        google: {
          model: "gemini-3.1-flash-tts-preview",
          speakerVoice: "Kore",
          audioProfile: "Говоріть професійно спокійним тоном.",
        },
      },
    },
  },
}

Ось чистий текст відповіді.

[[tts:text]][whispers] Ось озвучена версія.[[/tts:text]]

​

Голос у реальному часі

{
  plugins: {
    entries: {
      "voice-call": {
        enabled: true,
        config: {
          realtime: {
            enabled: true,
            provider: "google",
            providers: {
              google: {
                model: "gemini-3.1-flash-live-preview",
                speakerVoice: "Kore",
                activityHandling: "start-of-activity-interrupts",
                turnCoverage: "audio-activity-and-all-video",
              },
            },
          },
        },
      },
    },
  },
}

​

Розширена конфігурація

{
  agents: {
    defaults: {
      models: {
        "google/gemini-2.5-pro": {
          params: {
            cachedContent: "cachedContents/prebuilt-context",
          },
        },
      },
    },
  },
}

​

Пов’язані матеріали