Google (Gemini)

• Dostawca: google
• Uwierzytelnianie: GEMINI_API_KEY lub GOOGLE_API_KEY
• API: Google Gemini API
• Opcja środowiska uruchomieniowego: agentRuntime.id: "google-gemini-cli" ponownie wykorzystuje OAuth Gemini CLI, zachowując kanoniczne odwołania do modeli w postaci google/*.

​

Pierwsze kroki

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

# lub npm
npm install -g @google/gemini-cli

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

openclaw models list --provider google

​

Możliwości

​

Wyszukiwanie w internecie

{
  plugins: {
    entries: {
      google: {
        config: {
          webSearch: {
            apiKey: "AIza...", // opcjonalne, jeśli ustawiono GEMINI_API_KEY lub models.providers.google.apiKey
            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // w razie braku używa models.providers.google.baseUrl
            model: "gemini-2.5-flash",
          },
        },
      },
    },
  },
}

​

Generowanie obrazów

• Obsługuje także google/gemini-3-pro-image-preview
• Generowanie: maksymalnie 4 obrazy na żądanie
• Tryb edycji: włączony, maksymalnie 5 obrazów wejściowych
• Sterowanie geometrią: size, aspectRatio i resolution

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

​

Generowanie wideo

• Domyślny model wideo: google/veo-3.1-fast-generate-preview
• Tryby: zamiana tekstu na wideo, obrazu na wideo oraz przepływy z pojedynczym wideo referencyjnym
• Obsługuje aspectRatio (16:9, 9:16) i resolution (720P, 1080P); Veo obecnie nie obsługuje wyjściowego dźwięku
• Obsługiwane czasy trwania: 4, 6 lub 8 sekund (inne wartości są zaokrąglane do najbliższej dozwolonej wartości)

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

​

Generowanie muzyki

• Domyślny model muzyczny: google/lyria-3-clip-preview
• Obsługuje także google/lyria-3-pro-preview
• Sterowanie poleceniem: lyrics i instrumental
• Format wyjściowy: domyślnie mp3, a także wav w google/lyria-3-pro-preview
• Dane referencyjne: maksymalnie 10 obrazów
• Uruchomienia korzystające z sesji są odłączane za pośrednictwem współdzielonego przepływu zadań/stanu, w tym action: "status"

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

​

Zamiana tekstu na mowę

• Domyślny głos: Kore
• Uwierzytelnianie: messages.tts.providers.google.apiKey, models.providers.google.apiKey, GEMINI_API_KEY lub GOOGLE_API_KEY
• Dane wyjściowe: WAV dla zwykłych załączników TTS, Opus dla docelowych wiadomości głosowych, PCM dla Talk/telefonii
• Dane wyjściowe wiadomości głosowych: format PCM Google jest opakowywany jako WAV i transkodowany do Opus 48 kHz za pomocą ffmpeg

{
  messages: {
    tts: {
      auto: "always",
      provider: "google",
      providers: {
        google: {
          model: "gemini-3.1-flash-tts-preview",
          speakerVoice: "Kore",
          audioProfile: "Mów profesjonalnie i spokojnym tonem.",
        },
      },
    },
  },
}

Oto czysty tekst odpowiedzi.

[[tts:text]][whispers] Oto wersja mówiona.[[/tts:text]]

​

Głos w czasie rzeczywistym

{
  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",
              },
            },
          },
        },
      },
    },
  },
}

​

Konfiguracja zaawansowana

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

​

Powiązane