Langsung ke konten utama

​
Google (Gemini)

Plugin Google menyediakan akses ke model Gemini melalui Google AI Studio, plus pembuatan gambar, pemahaman media (gambar/audio/video), dan pencarian web melalui Gemini Grounding.
  • Provider: google
  • Auth: GEMINI_API_KEY atau GOOGLE_API_KEY
  • API: Google Gemini API
  • Provider alternatif: google-gemini-cli (OAuth)

​
Mulai cepat

  1. Set API key:
openclaw onboard --auth-choice gemini-api-key
  1. Set model default:
{
  agents: {
    defaults: {
      model: { primary: "google/gemini-3.1-pro-preview" },
    },
  },
}

​
Contoh non-interaktif

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

​
OAuth (Gemini CLI)

Provider alternatif google-gemini-cli menggunakan PKCE OAuth alih-alih API key. Ini adalah integrasi tidak resmi; beberapa pengguna melaporkan pembatasan akun. Gunakan dengan risiko Anda sendiri.
  • Model default: google-gemini-cli/gemini-3.1-pro-preview
  • Alias: gemini-cli
  • Prasyarat instalasi: Gemini CLI lokal tersedia sebagai gemini
    • Homebrew: brew install gemini-cli
    • npm: npm install -g @google/gemini-cli
  • Login:
openclaw models auth login --provider google-gemini-cli --set-default
Environment variable:
  • OPENCLAW_GEMINI_OAUTH_CLIENT_ID
  • OPENCLAW_GEMINI_OAUTH_CLIENT_SECRET
(Atau varian GEMINI_CLI_*.) Jika permintaan Gemini CLI OAuth gagal setelah login, set GOOGLE_CLOUD_PROJECT atau GOOGLE_CLOUD_PROJECT_ID di gateway host lalu coba lagi. Jika login gagal sebelum alur browser dimulai, pastikan perintah gemini lokal terinstal dan ada di PATH. OpenClaw mendukung instalasi Homebrew dan instalasi npm global, termasuk layout Windows/npm yang umum. Catatan penggunaan JSON Gemini CLI:
  • Teks balasan berasal dari field response JSON CLI.
  • Usage menggunakan fallback ke stats saat CLI membiarkan usage kosong.
  • stats.cached dinormalisasi ke cacheRead OpenClaw.
  • Jika stats.input hilang, OpenClaw menurunkan token input dari stats.input_tokens - stats.cached.

​
Kapabilitas

KapabilitasDidukung
Chat completionsYa
Pembuatan gambarYa
Pemahaman gambarYa
Transkripsi audioYa
Pemahaman videoYa
Pencarian web (Grounding)Ya
Thinking/reasoningYa (Gemini 3.1+)

​
Penggunaan ulang cache Gemini langsung

Untuk eksekusi Gemini API langsung (api: "google-generative-ai"), OpenClaw kini meneruskan handle cachedContent yang dikonfigurasi ke permintaan Gemini.
  • Konfigurasikan params per-model atau global dengan salah satu dari cachedContent atau cached_content legacy
  • Jika keduanya ada, cachedContent yang menang
  • Contoh nilai: cachedContents/prebuilt-context
  • Penggunaan cache-hit Gemini dinormalisasi ke cacheRead OpenClaw dari cachedContentTokenCount upstream
Contoh: 
{
  agents: {
    defaults: {
      models: {
        "google/gemini-2.5-pro": {
          params: {
            cachedContent: "cachedContents/prebuilt-context",
          },
        },
      },
    },
  },
}

​
Pembuatan gambar

Provider pembuatan gambar bundled google menggunakan default google/gemini-3.1-flash-image-preview.
  • Juga mendukung google/gemini-3-pro-image-preview
  • Generate: hingga 4 gambar per permintaan
  • Mode edit: diaktifkan, hingga 5 gambar input
  • Kontrol geometri: size, aspectRatio, dan resolution
Provider google-gemini-cli yang hanya OAuth adalah permukaan inferensi teks yang terpisah. Pembuatan gambar, pemahaman media, dan Gemini Grounding tetap berada di id provider google.

​
Catatan environment

Jika Gateway berjalan sebagai daemon (launchd/systemd), pastikan GEMINI_API_KEY tersedia untuk proses tersebut (misalnya, di ~/.openclaw/.env atau melalui env.shellEnv).