Skip to content

use-google-gemini.mdx

Latest commit

 

History

History
80 lines (64 loc) · 3.7 KB

use-google-gemini.mdx

File metadata and controls

80 lines (64 loc) · 3.7 KB
Raw
title Use Google Gemini
sidebar-title Use Google Gemini
description Configure NemoClaw to use Google Gemini through its OpenAI-compatible endpoint.
description-agent Sets up Google Gemini as the NemoClaw inference provider. Use when onboarding with a Gemini API key or selecting a curated Gemini model.
keywords
NemoClaw Gemini
Google Gemini inference
GEMINI_API_KEY
content
type
how_to

The Google Gemini provider routes NemoClaw to Google's OpenAI-compatible Chat Completions endpoint. The sandbox continues to use the managed inference.local route.

Credential

Set GEMINI_API_KEY in the host shell before onboarding. NemoClaw keeps the credential on the host and uses provider-aware validation during retries.

Model Choices

The onboarding wizard offers these curated model IDs.

  • gemini-3.1-pro-preview.
  • gemini-3.1-flash-lite-preview.
  • gemini-3-flash-preview.
  • gemini-2.5-pro.
  • gemini-2.5-flash.
  • gemini-2.5-flash-lite.

Onboard

Run the onboarding wizard and select Google Gemini.

$$nemoclaw onboard

Select a model when the wizard prompts you. NemoClaw validates the selected provider and model before creating the sandbox.

Validation

NemoClaw validates Gemini inference through its OpenAI-compatible Chat Completions path. When you enter a custom Gemini model ID, NemoClaw checks Google's native model catalog and accepts IDs with or without the models/ prefix. It skips the Responses API probe because Gemini does not support /v1/responses. When NemoClaw reads the native Google model catalog, it keeps only models that support generateContent. Embedding-only models are filtered out of the catalog, so they do not appear as onboarding choices.

Troubleshooting

Model validation can fail with these messages:

  • Could not validate model against https://generativelanguage.googleapis.com/v1beta/models: <reason> NemoClaw could not read the Google model catalog. The <reason> value identifies an authentication, network, response, or pagination failure. Verify GEMINI_API_KEY, host access to generativelanguage.googleapis.com, and the reported response.
  • Model '<model>' is not available from Google Gemini. Checked https://generativelanguage.googleapis.com/v1beta/models. The catalog did not contain the model ID. Check the ID for typing errors. Custom IDs can include or omit the models/ prefix. Embedding-only models do not appear because they do not support generateContent.
  • Unexpected Gemini model catalog response: expected a top-level models array The Google model catalog returned JSON with the wrong shape. Retry the request, then inspect the Google service or proxy response if the error continues.
  • Gemini model catalog pagination repeated page token '<token>' The catalog repeated a nextPageToken, so NemoClaw stopped reading pages. Retry the request, then inspect the Google service or proxy response if the error continues.
  • Gemini model catalog pagination exceeded <count> pages The catalog exhausted the 25-page GEMINI_MODEL_CATALOG_MAX_PAGES limit. Retry the request, then inspect the Google service or proxy response if the error continues.
  • Onboard inference smoke check failed. The validation request failed. The output shows the provider, model, and API base URL. Compare these values with your configuration.

Related Topics