> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemoclaw/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemoclaw/_mcp/server.

# Use Google Gemini

> Configure NemoClaw to use Google Gemini through its OpenAI-compatible endpoint.

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.6-flash`.
* `gemini-3.1-pro-preview`.
* `gemini-3.1-flash-lite-preview`.
* `gemini-3-flash-preview`.
* `gemini-2.5-pro`.
* `gemini-2.5-flash-lite`.

The wizard selects `gemini-3.6-flash` by default.

## Onboard

Run the onboarding wizard and select **Google Gemini**.

```bash
nemo-deepagents 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.
  This message also appears when the catalog omits `models`, because NemoClaw treats the response as an empty catalog.
  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 a non-null `models` value that is not an array.
  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.
* `Validation probe summary: Chat Completions API: HTTP 404.`
  This result comes from Google's OpenAI-compatible `/v1beta/openai/chat/completions` runtime route, not the native `/v1beta/models` catalog.
  A model appearing in the native catalog does not prove that the runtime route can serve it.
  NemoClaw stops because the sandbox uses the Chat Completions route for inference.
  Retry the request, then verify that the same key and model can invoke Google's OpenAI-compatible Chat Completions endpoint.

## Related Topics

* [Choose a Model](../learn-and-choose/choose-model) compares the curated Gemini models by task fit.
* [Understand Provider Validation](../validate-inference/understand-provider-validation) describes provider validation behavior.