OpenClaw mit Google Gemini verbinden

Kennst du das Problem? Du willst ein Projekt mit LLMs bauen, aber die Token-Kosten schießen sofort in die Höhe. Oder noch schlimmer: Dein Modell vergisst den Anfang der Konversation, weil das Context Window zu klein ist, sobald du ein paar längere Dokumente hochlädst.

Google Gemini ist hier ein echter Geheimtipp, da der Free Tier extrem großzügig ist. Während andere Provider jeden Token einzeln abrechnen, bietet Gemini dir 1 Million Token Context und einen soliden kostenlosen Zugang. Wenn du lange Dokumente verarbeiten oder eine umfangreiche History behalten willst, ist Gemini schwer zu schlagen.

So richtest du es in OpenClaw ein.

Why Gemini?

Feature	Gemini	Claude	GPT-4
Free Tier	✅ Ja	❌ Nein	❌ Nein
Context Window	1M Tokens	200K Tokens	128K Tokens
Multimodal	✅ Bilder, Audio, Video	✅ Bilder	✅ Bilder
Speed	Schnell	Mittel	Mittel

Voraussetzungen

• Google Account
• Zugriff auf Google AI Studio
• OpenClaw Installation

Quick Start (5 Minuten)

Schritt 1: API Key holen

1. Gehe zu Google AI Studio.
2. Melde dich mit deinem Google-Konto an.
3. Klicke auf “Get API Key” → “Create API Key”.
4. Kopiere den Key.

Schritt 2: OpenClaw konfigurieren

Du hast zwei Möglichkeiten, den Key zu hinterlegen:

Option A: Environment Variable

export GEMINI_API_KEY="your-api-key-here"

Option B: CLI Configuration

openclaw config set models.providers.gemini.apiKey "your-api-key-here"

Schritt 3: Gemini als Modell festlegen

Bearbeite deine OpenClaw-Config:

{
  agents: {
    defaults: {
      model: { primary: "gemini/gemini-2.5-flash" }
    }
  }
}

Schritt 4: Verbindung testen

Starte OpenClaw und sende eine Test-Anfrage, um sicherzustellen, dass die Kommunikation mit dem Gateway funktioniert.

OAuth Authentication (Alternative)

Für eine sicherere Authentifizierung ohne Keys direkt über dein Google-Konto:

Option 1: Während des Onboarding Wizard

1. Starte openclaw onboard.
2. Wähle “Google” als AI Provider.
3. Wähle “OAuth Authentication”.
4. Schließe den Google Login im Browser ab.

Option 2: CLI Plugin Authentication

Falls OpenClaw schon läuft, aktiviere das Gemini CLI Auth Plugin:

# Gemini CLI auth plugin aktivieren
openclaw plugins enable google-gemini-cli-auth

# Authentifizieren und als Standard setzen
openclaw models auth login --provider google-gemini-cli --set-default

Das öffnet ein Browserfenster für den Google OAuth Login. Danach nutzt du Gemini ohne manuelle API Keys.

Hinweis: OAuth ist super für den persönlichen Gebrauch. Für Automatisierungen oder Server-Deployments solltest du stattdessen einen API Key nutzen.

Verfügbare Gemini Modelle

Model	Best For	Context Window
gemini-2.5-flash	Schnelle Antworten	1M Tokens
gemini-2.5-pro	Komplexe Logik	1M Tokens
gemini-2.0-flash	Ausgewogen	128K Tokens
gemini-1.5-flash	Legacy Support	1M Tokens

Modell-Auswahl

{
  agents: {
    defaults: {
      model: {
        primary: "gemini/gemini-2.5-flash",
        fallback: ["gemini/gemini-2.0-flash"]
      }
    }
  }
}

Gemini Free Tier verstehen

Googles kostenloser Plan beinhaltet:

• 60 Requests pro Minute (Flash Modelle)
• 2 Requests pro Minute (Pro Modelle)
• 1 Million Token Context Window
• Tägliche Kontingente

Für die meisten persönlichen Projekte reicht dieser Free Tier völlig aus.

Rate Limits

Wenn du gegen Limits stößt, helfen diese Strategien:

• Wechsle zu Flash Modellen für höhere Limits.
• Baue Verzögerungen zwischen den Requests ein.

Advanced Configuration

Full Provider Setup

{
  models: {
    providers: {
      gemini: {
        apiKey: "your-api-key",
        models: [
          {
            id: "gemini-2.5-flash",
            name: "Gemini 2.5 Flash",
            reasoning: false,
            input: ["text", "image"],
            contextWindow: 1000000,
            maxTokens: 8192
          }
        ]
      }
    }
  }
}

Nutzung mit anderen Providern

Du kannst Gemini mit anderen Modellen mischen:

{
  agents: {
    defaults: {
      model: {
        primary: "gemini/gemini-2.5-flash",  // Schnell und kostenlos
        fallback: ["anthropic/claude-sonnet-4"] // Für komplexe Aufgaben
      }
    }
  }
}

Fehlerbehebung

”API key not valid”

Prüfe deinen API Key:

1. Gehe zum Google AI Studio.
2. Checke, ob der Key aktiv ist.
3. Achte darauf, dass beim Kopieren keine Leerzeichen mitgerutscht sind.

”Quota exceeded”

Du hast das Limit des Free Tier erreicht. Deine Optionen:

• Warte auf den Reset des Kontingents (täglich).
• Nutze Flash Modelle für höhere Limits.
• Upgrade auf einen Paid Plan.

”Model not found”

Überprüfe die Modell-ID mit diesem Befehl:

openclaw models list

Stelle sicher, dass das Format stimmt: gemini/model-name.

Verbindungsprobleme

Prüfe deine Internetverbindung und ob die Google API in deiner Region verfügbar ist.

Du kommst trotzdem nicht weiter? Unser AI Setup Assistant kennt die gesamte OpenClaw-Dokumentation und hilft dir in Echtzeit bei deinem Gemini-Setup.

Gemini vs. andere Provider

Aspekt	Gemini	Claude	OpenAI
Ideal für	Lange Dokumente	Kreatives Schreiben	Coding & Analyse
Free Tier	✅ Großzügig	❌ Keiner	❌ Keiner
Context	1M Tokens	200K Tokens	128K Tokens
Coding	Gut	Exzellent	Exzellent

Meine Empfehlung: Nutze Gemini für die Verarbeitung großer Dokumente und als kosteneffizienten Fallback. Reserviere Claude oder GPT für Aufgaben, die die absolut höchste Ausgabequalität erfordern.

Nächste Schritte

• Install OpenClaw → — Komplette Anleitung
• Use Ollama → — Kostenlose lokale KI
• Connect Telegram → — Steuerung per Handy
• Docker deployment → — 24/7 Betrieb

---

Hilfe nötig? Komm auf den OpenClaw Discord oder lies die offiziellen Docs.