Gemini и OpenClaw: настройка Google AI | open-claw.su

Google Gemini — семейство мультимодальных моделей от Google. Gemini умеет работать с текстом, изображениями, видео и кодом. OpenClaw поддерживает Gemini через четыре провайдера — от простого API-ключа до корпоративного Vertex AI.

Четыре способа подключения

Способ	Провайдер	Авторизация	Для кого
API-ключ	`google`	`GEMINI_API_KEY`	Большинство пользователей
OpenRouter	`openrouter`	`OPENROUTER_API_KEY`	Если уже используете OpenRouter
Vertex AI	`google-vertex`	gcloud ADC	Корпоративные пользователи GCP
Плагины	`google-antigravity` / `google-gemini-cli`	OAuth через плагин	Альтернативная авторизация

Для большинства пользователей рекомендуется Способ 1 (API-ключ) — он самый простой.

Из России: Google AI API может быть недоступен без VPN. Если прямой доступ не работает — используйте Gemini через OpenRouter (Способ 2) или настройте VPN. Подробнее о доступе из РФ — в статье OpenClaw в России.

Способ 1: API-ключ (рекомендуется)

Самый быстрый способ начать работу с Gemini.

1. Получите API-ключ

Перейдите на Google AI Studio
Войдите через Google-аккаунт
Перейдите в раздел API Keys → Create API key
Скопируйте ключ

2. Установите переменную окружения

Добавьте ключ в файл ~/.openclaw/.env:

GEMINI_API_KEY=ваш-ключ-сюда

3. Настройте OpenClaw

// ~/.openclaw/openclaw.json
{
  agent: {
    model: "google/gemini-3-pro-preview",
  },
}

4. Перезапустите агента

openclaw gateway restart

Ротация ключей

Если вы хотите распределить нагрузку между несколькими ключами, OpenClaw поддерживает ротацию:

# ~/.openclaw/.env — несколько ключей
GEMINI_API_KEY_1=ключ-1
GEMINI_API_KEY_2=ключ-2

Или через единую переменную с разделителем:

GEMINI_API_KEYS=ключ-1,ключ-2,ключ-3

Также поддерживается fallback на GOOGLE_API_KEY, если GEMINI_API_KEY не задан.

Способ 2: Через OpenRouter

Если вы уже используете OpenRouter, Gemini доступен без дополнительной настройки — через тот же ключ.

// ~/.openclaw/openclaw.json
{
  agent: {
    model: "openrouter/google/gemini-2.5-pro",
  },
}

Бесплатная версия (50 запросов/день):

{
  agent: {
    model: "openrouter/google/gemini-2.0-flash-exp:free",
  },
}

Подробнее о настройке OpenRouter — в гайде OpenRouter для OpenClaw.

Способ 3: Google Vertex AI (для корпоративных пользователей)

Vertex AI — облачная платформа Google для ML. Подходит для организаций, которые уже работают с Google Cloud Platform (GCP).

Настройка

Настройте проект в Google Cloud Console
Включите Vertex AI API
Установите gcloud CLI и авторизуйтесь:

gcloud auth application-default login

Укажите провайдер в конфигурации:

// ~/.openclaw/openclaw.json
{
  agent: {
    model: "google-vertex/gemini-3-pro-preview",
  },
}

Vertex AI использует Application Default Credentials (ADC) — отдельный API-ключ не нужен. Авторизация через gcloud достаточна.

Способ 4: Плагины (Antigravity / Gemini CLI)

OpenClaw поддерживает два плагина для альтернативной авторизации в Google. Оба отключены по умолчанию.

Google Antigravity

# Включить плагин
openclaw plugins enable google-antigravity-auth

// ~/.openclaw/openclaw.json
{
  agent: {
    model: "google-antigravity/gemini-3-pro-preview",
  },
}

Google Gemini CLI

# Включить плагин
openclaw plugins enable google-gemini-cli-auth

// ~/.openclaw/openclaw.json
{
  agent: {
    model: "google-gemini-cli/gemini-3-pro-preview",
  },
}

Оба плагина используют OAuth-авторизацию через браузер. После первого входа токен сохраняется локально.

Gemini как провайдер эмбеддингов

Помимо использования в качестве языковой модели, Gemini служит одним из провайдеров эмбеддингов для системы памяти OpenClaw. Если GEMINI_API_KEY задан — эмбеддинги для векторного поиска по памяти будут работать через Gemini автоматически, без дополнительной настройки.

Подробнее о приоритетах провайдеров эмбеддингов и настройке памяти — в статье Память OpenClaw.

Типичные проблемы

«Access not configured» или «Invalid API key»

Проверьте, что GEMINI_API_KEY задан в ~/.openclaw/.env
Убедитесь, что ключ действителен — проверьте на Google AI Studio
Если используете Vertex — проверьте gcloud auth application-default login

«Model not found»

Проверьте формат модели: google/gemini-3-pro-preview (с префиксом провайдера)
Через OpenRouter формат другой: openrouter/google/gemini-2.5-pro
Через Vertex: google-vertex/gemini-3-pro-preview

Плагин не активируется

Убедитесь, что запустили openclaw plugins enable <имя-плагина>
Перезапустите gateway: openclaw gateway restart

Медленные ответы

Попробуйте другой регион (для Vertex AI)
Используйте Flash-версию модели для быстрых задач
При пиковой нагрузке Google может ограничивать скорость

Что дальше

Обзор всех моделей — сравнение Gemini с Claude, GPT-4o, DeepSeek и другими
OpenRouter для OpenClaw — единый ключ для всех моделей, включая Gemini
Память OpenClaw — как работает система памяти с эмбеддингами Gemini
Настройка SOUL.md — как задать характер и правила поведения агента