OpenClaw mit Gemini: Modelle einrichten, API-Schlüssel und Kosten prüfen

OpenClaw greift über sein mitgeliefertes google-Plugin auf Gemini zu: Setze GEMINI_API_KEY oder GOOGLE_API_KEY, führe openclaw onboard --auth-choice gemini-api-key aus und lege das Modell anschließend ausdrücklich fest — denn das Hinzufügen von Authentifizierung ändert dein Standardmodell nicht. Der meist übersehene Punkt bei Einrichtungstexten ist, dass OpenClaw bei einem AI-Studio-Schlüssel drei getrennte Gemini-Oberflächen besitzt, jeweils mit eigenen Anmeldedaten, Endpunkten und Kosten. (Vertex AI ist ein vierter, separater Anmeldeinformationspfad über gcloud Application Default Credentials und wird hier nicht behandelt.) Wenn der Chat funktioniert, ist die Gemini-Suche nicht aktiviert; und die Aktivierung der Gemini-Suche kann ein Google-Projekt belasten, das deine Chat-Route nie verwendet.

Die Gemini-Integration ist keine separate Installation. Sie ist als mitgeliefertes google-Anbieter-Plugin direkt in OpenClaw enthalten (offizielle Anbieter-Plugins, 21. September 2026), und OpenClaw ist MIT-lizenziert und auf npm als openclaw@2026.9.5 veröffentlicht; erforderlich ist Node >=24.16.0 <25 || >=26.1.0 (npm-Registry, 21. September 2026). Die Software kostet nichts; alles Folgende betrifft die Kosten der Schlüssel.

Drei Gemini-Oberflächen, drei Anmeldedaten

Der entscheidende Teil sind die Prioritätsregeln. Die Gemini-Websuche liest zuerst plugins.entries.google.config.webSearch.apiKey, dann GEMINI_API_KEY, dann models.providers.google.apiKey, und das dedizierte webSearch.baseUrl hat Vorrang vor models.providers.google.baseUrl. OpenClaw übernimmt hier außerdem keine Header des Modellanbieters, weil sie „zum Endpunkt des Modellanbieters gehören, der sich vom Websuchendpunkt unterscheiden kann“, und behält Content-Type, x-goog-api-key und x-goog-api-client für die Suchanfrage selbst unter eigener Kontrolle (Gemini-Suchdokumentation, 21. September 2026). Zwei Routen, bewusst unabhängig.

Bevor du einem älteren Tutorial folgst: OpenClaw erklärt, dass es „keine neue Einrichtung von Gemini-CLI-OAuth oder Antigravity-OAuth anbietet“, und verweist auf das Ende des Verbraucherzugangs zu Gemini CLI Login with Google am 18. Juni 2026 (Anbieterdokumentation). Googles eigener Beitrag vom 19. Mai 2026 sagt, dass Gemini CLI und Code-Assist-IDE-Erweiterungen Google-AI-Pro- und-Ultra-Abonnenten sowie kostenlose Nutzer nicht mehr bedienen (Google-Developers-Blog). Beide Aussagen betreffen die CLI- und IDE-Oberfläche, nicht AI-Studio-API-Schlüssel — der API-Schlüsselpfad ist der folgende.

Gemini-API-Schlüssel festlegen

# The bundled google plugin reads either name.
export GEMINI_API_KEY="AIza..."   # or GOOGLE_API_KEY

openclaw onboard --auth-choice gemini-api-key

# Auth alone does not change the default model — set it on purpose.
openclaw models list --provider google
openclaw models set google/<id-from-that-list>

Das mitgelieferte Plugin liest außerdem GEMINI_API_KEYS, GEMINI_API_KEY_1 und GEMINI_API_KEY_2 zur Rotation sowie OPENCLAW_LIVE_GEMINI_KEY als einzelne Überschreibung (offizielle Anbieter-Plugins, 21. September 2026). Diese Variablen sind als eigene Variablen des google-Plugins dokumentiert; die Referenz für benutzerdefinierte Anbieter führt sie nicht für eine selbst deklarierte Anbieter-ID auf, deren Schlüssel über apiKey gesetzt wird ($${ENV_VAR}-Erweiterung ist dort gezeigt).

Die letzte Zeile ist wichtiger, als sie zunächst wirkt. openclaw configure „bewahrt ein vorhandenes agents.defaults.model.primary auf, wenn du einen Anbieter hinzufügst oder erneut authentifizierst“, und openclaw models auth login verhält sich ebenso, sofern du nicht --set-default übergibst (Schnellregeln). Dass du Gemini authentifizierst und weiterhin Antworten vom alten Modell erhältst, ist erwartetes Verhalten, kein Fehler.

Übernimm keine Modell-ID aus irgendeinem Tutorial, auch nicht aus diesem. Mit einem konfigurierten Schlüssel aktualisiert OpenClaw den Textmodellkatalog von Google AI Studio über die Gemini-models.list-API, sodass neue Varianten ohne eine OpenClaw-Version erscheinen — und die eigenen OpenClaw-Seiten widersprechen sich beim Beispiel-ID: An einer Stelle nennen sie google/gemini-3.5-flash, an einer anderen google/gemini-3.1-flash und google/gemini-3.1-pro-preview, während das Suchtool standardmäßig gemini-3.6-flash verwendet. Die aktuelle Liste ist die einzige maßgebliche Quelle. OpenClaw normalisiert einige ältere Referenzen — google/gemini-3.1-pro wird „akzeptiert und normalisiert“ zu google/gemini-3.1-pro-preview (offizielle Anbieter-Plugins) — und google/gemini-3-pro-preview „wurde am 2026-03-09 eingestellt“, wobei google/gemini-3.1-pro-preview als Ersatz genannt wird (Anbieterdokumentation, 21. September 2026).

Was ein Gemini-API-Schlüssel tatsächlich abrechnet

Tokens und Such-Grounding sind zwei getrennte Rechnungsposten, die auf Googles Seite auf den ersten Blick wie ein einziger wirken. Die Preise der Standardstufe der Gemini Developer API pro 1 Mio. Tokens stammen von Googles Preisseite (zuletzt aktualisiert am 16. September 2026, gelesen am 21. September 2026):

Lies die letzte Spalte zweimal. OpenClaws standardmäßiges Gemini-Websuchmodell ist gemini-3.6-flash, ein Gemini-3.x-Modell, dessen Grounding in Googles kostenloser Stufe „Nicht verfügbar“ ist — die Gemini-Suche benötigt daher standardmäßig ein Projekt mit aktivierter Abrechnung, obwohl die Tokens desselben Modells kostenlos sind. Auch die Einheiten unterscheiden sich: OpenClaw weist selbst darauf hin, dass „Gemini-3-Grounding pro Suchanfrage abgerechnet wird, während Gemini-2.5-Grounding pro Prompt abgerechnet wird“, und Google ergänzt, dass eine Anfrage „zu einer oder mehreren Abfragen an Google Search führen kann. Für jede einzelne ausgeführte Suchabfrage wird eine Gebühr berechnet“. Grounding kommt zu den Tokenkosten hinzu — „Kosten für Gemini fallen immer an“ (beide Zitate stammen von derselben Preisseite). Beispielhaft werden bei 6.500 Gemini-3.x-Suchanfragen in einem Monat 1.500 davon mit $14 pro 1.000 berechnet, also $21.00 allein an Suchgebühren, vor den Tokenkosten.

Zwei weitere Angaben derselben Seite: Die bezahlte Stufe bietet Kontext-Caching und eine Batch API mit 50 % Kostenreduzierung, und sie kehrt den Datenverwendungshinweis um — Inhalte der kostenlosen Stufe werden „zur Verbesserung unserer Produkte verwendet“, Inhalte der bezahlten Stufe nicht; das ist für einen ständig aktiven Assistenten relevant. Gemini ist außerdem nur einer der OpenClaw-Suchanbieter; DuckDuckGo („Keine (schlüsselfrei)“), SearXNG („Keine (selbst gehostet)“) und Parallel Search (Free) („Keine (kostenloses Search MCP)“) werden in der Tabelle der Websuchanbieter als schlüsselfreie Optionen aufgeführt (Websuche, 21. September 2026). Die Frage „Brauche ich Gemini-Grounding überhaupt?“ ist daher ein sinnvoller Ausgangspunkt.

Gemini-Chat über ein OpenAI-kompatibles Gateway routen

OpenClaws Referenz für benutzerdefinierte Anbieter sagt, explizite models.providers.<id>-Einträge sollten „nur verwendet werden, wenn du die standardmäßige Basis-URL, Header oder Modellliste überschreiben möchtest“. Die Referenz zur Gateway-Konfiguration führt elf api-Werte auf: openai-completions, openai-responses, openai-chatgpt-responses, anthropic-messages, google-generative-ai, google-vertex, github-copilot, bedrock-converse-stream, ollama, pi-messages und azure-openai-responses. Das Konfigurationsschema in v2026.9.7 akzeptiert einen zwölften Wert, google-interactions, der am 25. September 2026 hinzugefügt wurde. Die Referenz führt ihn noch nicht auf, aber OpenClaws Google-Anbieterseite dokumentiert ihn als optionale Alternative zum standardmäßigen google-generative-ai-Transport, unter Verwendung von Geminis Interactions API mit https://generativelanguage.googleapis.com/v1beta. Kunavos Gemini-Modelle werden über seine OpenAI-kompatible Oberfläche unter POST /v1/chat/completions erreicht (Chat-Endpunkt), und Kunavo veröffentlicht keinen generativelanguage, v1beta- oder Interactions-Endpunkt — daher erreicht keiner der Google-Adapter Kunavo. Die erreichbare Route ist eine separate Anbieter-ID, niemals ein umgeleitetes google-Plugin.

{
  "models": {
    "mode": "merge",
    "providers": {
      "kunavo": {
        "baseUrl": "https://api.kunavo.com/v1",
        "apiKey": "${KUNAVO_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "gemini-3-8-flash",
            "name": "Gemini 3.8 Flash",
            "input": [
              "text",
              "image"
            ],
            "contextWindow": 1048576,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "kunavo/gemini-3-8-flash"
      }
    }
  }
}

Vier Details sind dort entscheidend. Der Slug enthält Bindestriche — Kunavos ID lautet gemini-3-8-flash, während Googles und OpenClaws IDs Punkte enthalten; es handelt sich um unterschiedliche Zeichenfolgen. contextWindow wird angegeben, weil ein benutzerdefiniertes Modell ohne Kontextmetadaten auf ein Budget von 200.000 Tokens zurückfällt und dadurch der größte Teil des von Kunavos Katalog hier aufgezeichneten Fensters ungenutzt bleibt (1.048.576 Tokens — Kunavos Metadaten, kein von Google veröffentlichter Grenzwert). input benennt Bilder, weil OpenClaw ein benutzerdefiniertes Modell standardmäßig nur für Text verwendet. Und cost wird weggelassen, sodass OpenClaws lokale Schätzung auf dieser Route standardmäßig null beträgt: Eine Anzeige von $0 bedeutet fehlende Metadaten, nicht kostenlose Inferenz.

Was diese Route aufgibt, ist dokumentiert und nicht geraten. Bei api: "openai-completions" gegen einen Host, der nicht OpenAI gehört, erzwingt OpenClaw compat.supportsDeveloperRole: false und überspringt die native Anfrageaufbereitung — kein service_tier, kein Responses- oder Completions-store, keine Hinweise auf Prompt-Caching und keine Payload-Aufbereitung für Reasoning-Kompatibilität (Benutzerdefinierte Anbieter). Auch die Gemini-spezifischen Extras bleiben außen vor: params.cachedContent ist für direkte Gemini-Ausführungen dokumentiert, die Schlüsselrotationsvariablen sind Plugin-Funktionen, und OpenClaws Zuordnung thinkingLevel / thinkingBudget wird für den Anbieter google beschrieben — ob sie über eine Gateway-Route erhalten bleibt, wurde auf dieser Seite nicht überprüft.

Kunavo stellt kein Einbettungsmodell sowie kein Text-zu-Sprache- oder Sprache-zu-Text-Modell bereit. Die Einbettungs- und Sprachverträge des google-Plugins bleiben daher unabhängig vom Chat-Routing bei einem Google-Schlüssel.

Bei den Fähigkeiten solltest du genau darauf achten, wessen Aussage du übernimmst. Googles aktuelle Modellseite zeigt keine Tokenlimits pro Modell mehr an; eine anderswo zitierte Kontextgröße stammt daher aus einer älteren Quelle. Kunavos Katalog kennzeichnet bei seinen Gemini-Listings Vision, Function Calling, Streaming und langen Kontext sowie Thinking bei allen außer gemini-2-5-flash. Jede Aussage ist auf den jeweiligen Herausgeber beschränkt — überprüfe Tool-Aufrufe zuerst mit deiner eigenen Aufgabe.

Das tatsächlich ausgewählte Modell bepreisen

Pro Modell gegenüber Googles Standardstufe, denn die familienweite Version dieses Vergleichs ist heute falsch:

Kunavos Preise stammen aus dem aktuellen Katalog, Googles Preise aus der am 21. September 2026 gelesenen Preisseite; der Einführungszeitraum endet am 31. Dezember 2026, danach kehrt sich der Flash-Vergleich erneut um.

Eine Beispielschätzung, die Tokenarithmetik und keine gemessene OpenClaw-Aufgabe oder Kostenobergrenze ist. Angenommen wird eine Woche Assistentenarbeit mit 4.000.000 nicht gecachten Eingabetokens und 150.000 Ausgabetokens, ohne Caching und ohne Suche. Auf Gemini 3.8 Flash zu Kunavos Preisen ergibt das $2.49; dieselbe Rechnung zum Google-Einführungspreis für Flash ergibt $3.56 und steigt zum Preis von 2027 auf $7.13. Führst du dieselben Mengen auf Gemini 3.6 Flash bei Kunavo aus, erhältst du $4.99 — mehr als der Google-Einführungsbetrag. Genau deshalb ist die Modell-ID und nicht der Anbietername die entscheidende Wahl.

Der Katalogbetrag von Kunavo ist eine Abrechnungsuntergrenze, keine Obergrenze: Wenn der Upstream seine Gebühr meldet, entspricht die Rechnung dem höheren Wert aus den Katalogkosten und den Upstream-Kosten multipliziert mit dem anwendbaren Aufschlag. Cache-Gebühren, Suchgrundierung und Hosting liegen außerhalb dieses Beispiels, und die minimale Aufladung beträgt $10 als vorausbezahltes Guthaben — eine Finanzierungsuntergrenze, keine Aufgaben- oder Abonnementgebühr. Siehe Abrechnungsdetails und OpenClaw-Preise für die vollständigen Betriebskosten.

Mit einer Anfrage prüfen und anschließend beide Abrechnungen lesen

openclaw config validate
openclaw gateway restart
openclaw models list --provider kunavo
openclaw infer model run --model kunavo/gemini-3-8-flash --prompt "hi" --json

openclaw models list liest den veröffentlichten Bestand, und openclaw models status zeigt den aufgelösten Standard sowie den Authentifizierungsstatus; keines von beiden beweist, dass eine kostenpflichtige Aufgabe funktioniert. openclaw models set speichert bei einem bekannten Anbieter außerdem ein nicht katalogisiertes Modell nur mit einer Warnung. openclaw doctor --json --severity-min info zeigt auch aktive Modelle, die der lokale Katalog nicht bestätigen kann (CLI-Referenz). Die einzelne Anfrage oben ist der erste Nachweis, der Kosten verursacht.

Nach Statuscode analysieren. OpenClaw dokumentiert die model_not_found-Signatur für einen lokalen OpenAI-kompatiblen Server; die drei dort genannten Felder sind dieselben drei, die ein benutzerdefinierter Anbieter-Eintrag setzt: Prüfe, dass die baseUrl /v1 enthält, dass api für ein /v1/chat/completions-Backend "openai-completions" lautet und dass models[].id die unveränderte lokale Anbieter-ID ist, wobei der Anbieterpräfix nur bei der Auswahl verwendet wird (Fehlerbehebung). Bei Kunavo zeigt eine nicht authentifizierte Anfrage an einen echten API-Pfad, dass die Basis-URL stimmt: GET https://api.kunavo.com/v1/models antwortet mit 401 und einem authentication_error-Body — die URL stimmt, der Schlüssel fehlt. Der unveränderte Host und der unveränderte /v1-Pfad sind keine API-Pfade und antworten mit HTML; ein Client, der auf einen von beiden zeigt, scheitert, bevor er ein Modell erreicht (geprüft am 21. September 2026). Ein 403 ist der Status, bei dem du innehalten und die Antwort lesen solltest: OpenClaw warnt, er „kann von einer vorgeschalteten Sicherheitsschicht wie einem CDN, WAF, einer Bot-Management-Regel oder einem Reverse-Proxy stammen“, und ein erfolgreicher minimaler curl-Aufruf garantiert nicht, dass echte SDK-Anfragen dieselbe Schicht passieren. Siehe Modell nicht gefunden und Gemini-API-Schlüssel funktioniert nicht für die ausführlicheren Fassungen.

Für die native Route beginne mit Kunavos Hinweisen zum Gemini-API-Schlüssel und Google AI Studio; für die Gateway-Route erstelle einen Schlüssel unter API-Schlüssel und eröffne ein Kunavo-Konto, danach folge der Anleitung für benutzerdefinierte Anbieter unter beste API für OpenClaw. Halte deine funktionierende Route verfügbar, während du testest.

Welche Route gewinnt, wenn

Wenn du noch einen Anbieter auswählst, statt einen zu konfigurieren, decken Gemini-API-Preise und OpenAI-kompatible API die beiden Hälften dieser Entscheidung ab.

Häufig gestellte Fragen

Für diese Seite am 21. September 2026 abgerufen: OpenClaws Dokumentation zu Google-Anbieter, offiziellen Anbieter-Plugins, Gemini-Suche, Websuche, benutzerdefinierten Anbietern (sowohl Konzepte als auch Gateway-Referenz), Schnellregeln, CLI-Modellen und Fehlerbehebung; Googles Gemini-API-Preisseite (zuletzt aktualisiert am 16. September 2026), Modellseite, Seite zur Google-Search-Grundierung und Entwickler-Blogbeitrag vom 19. Mai 2026; der npm-Registry-Eintrag für openclaw; sowie Kunavos eigener Katalog. Am 1. Oktober 2026 wurden die api-Werte für benutzerdefinierte Anbieter erneut anhand der Gateway-Referenz, der Google-Anbieterseite sowie des OpenClaw-Konfigurationsschemas und des Interactions-Transports im Quellcode von v2026.9.7 überprüft. Die einzige für diese Seite ausgeführte Live-Anfrage war ein nicht authentifiziertes GET an Kunavos /v1/models, um den oben beschriebenen 401 aufzuzeichnen. Nichts davon wurde zur Laufzeit gegen eine OpenClaw-Installation, Kunavos Endpunkt oder Google getestet; alle Dollarbeträge sind beispielhafte Rechnungen auf Grundlage veröffentlichter Preise.