Google 提供商

OpenClaw 通过 google/* 命名空间接入 Google Gemini 系列模型，支持多模态生成、实时语音、Web 搜索等能力。

认证方式

API Key 认证：

{
  env: { GEMINI_API_KEY: "AIza..." },
  // 或使用 GOOGLE_API_KEY（两者等效）
  agents: {
    defaults: { model: { primary: "google/gemini-3.1-pro-preview" } }
  }
}

Gemini CLI OAuth 认证（复用已有 Gemini CLI 登录）：

{
  agents: {
    defaults: { model: { primary: "google/gemini-3.1-pro-preview" } }
  }
}

环境变量 GEMINI_API_KEY 和 GOOGLE_API_KEY 均被识别，优先级相同。

默认模型

google/gemini-3.1-pro-preview

功能覆盖

功能	模型
Chat	`gemini-3.1-pro-preview`, `gemini-2.5-pro`
图像生成	`gemini-3.1-flash-image-preview`
视频生成	`veo-3.1-fast`
音乐生成	`lyria-3-clip-preview`
TTS（文字转语音）	`gemini-3.1-flash-tts-preview`
Realtime Voice	Gemini Live API
Web 搜索	Grounding（内置搜索增强）

思考模式

Gemini 不同版本使用不同的思考控制参数：

Gemini 3 系列（新版）：

{
  params: { thinkingLevel: "high" }  // low / medium / high
}

Gemini 2.5 系列（旧版）：

{
  params: { thinkingBudget: 8192 }  // token 预算
}

Web 搜索（Grounding）

Gemini 内置 Google Search Grounding，可在对话中实时检索网络信息：

{
  agents: {
    defaults: {
      model: { primary: "google/gemini-3.1-pro-preview" },
      params: { grounding: true }
    }
  }
}

Wiki AI

目录