Google (Gemini)

• Dostawca: google
• Uwierzytelnianie: GEMINI_API_KEY lub GOOGLE_API_KEY
• API: Google Gemini API
• Opcja środowiska wykonawczego: provider/model agentRuntime.id: "google-gemini-cli" ponownie używa OAuth Gemini CLI, zachowując kanoniczne odwołania do modeli jako 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

# or 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 sieci

{
  plugins: {
    entries: {
      google: {
        config: {
          webSearch: {
            apiKey: "AIza...", // optional if GEMINI_API_KEY or models.providers.google.apiKey is set
            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // falls back to models.providers.google.baseUrl
            model: "gemini-2.5-flash",
          },
        },
      },
    },
  },
}

​

Generowanie obrazów

• Obsługuje także google/gemini-3-pro-image-preview
• Generowanie: do 4 obrazów na żądanie
• Tryb edycji: włączony, do 5 obrazów wejściowych
• Kontrolki geometrii: 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: tekst-na-wideo, obraz-na-wideo oraz przepływy z pojedynczym wideo referencyjnym
• Obsługuje aspectRatio (16:9, 9:16) i resolution (720P, 1080P); wyjście audio nie jest dziś obsługiwane przez Veo
• Obsługiwane czasy trwania: 4, 6 lub 8 sekund (inne wartości są dopasowywane do najbliższej dozwolonej wartości)

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

​

Generowanie muzyki

• Domyślny model muzyki: google/lyria-3-clip-preview
• Obsługuje także google/lyria-3-pro-preview
• Kontrolki promptu: lyrics i instrumental
• Format wyjściowy: domyślnie mp3, a dodatkowo wav w google/lyria-3-pro-preview
• Wejścia referencyjne: do 10 obrazów
• Uruchomienia oparte na sesji odłączają się przez współdzielony przepływ zadania/statusu, 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
• Wyjście: WAV dla zwykłych załączników TTS, Opus dla celów notatek głosowych, PCM dla Talk/telefonii
• Wyjście notatki głosowej: Google PCM 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: "Speak professionally with a calm tone.",
        },
      },
    },
  },
}

Here is the clean reply text.

[[tts:text]][whispers] Here is the spoken version.[[/tts:text]]

​

Głos w czasie rzeczywistym

{
  plugins: {
    entries: {
      "voice-call": {
        enabled: true,
        config: {
          realtime: {
            enabled: true,
            provider: "google",
            providers: {
              google: {
                model: "gemini-2.5-flash-native-audio-preview-12-2025",
                speakerVoice: "Kore",
                activityHandling: "start-of-activity-interrupts",
                turnCoverage: "only-activity",
              },
            },
          },
        },
      },
    },
  },
}

​

Konfiguracja zaawansowana

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

​

Powiązane