OpenClaw Google（Gemini）提供商配置指南

Google 插件提供了对 Gemini 模型的访问能力，支持 Google AI Studio，同时还支持图像生成、媒体理解（图像 / 音频 / 视频），以及通过 Gemini Grounding 实现的网页搜索。

• 提供商标识：google
• 鉴权方式：GEMINI_API_KEY 或 GOOGLE_API_KEY
• API 类型：Google Gemini API
• 替代提供商：google-gemini-cli（OAuth 认证）

快速开始

设置 API 密钥：

openclaw onboard --auth-choice google-api-key

设置默认模型：

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

非交互式示例

openclaw onboard --non-interactive \
--mode local \
--auth-choice google-api-key \
--gemini-api-key "$GEMINI_API_KEY"

OAuth（Gemini CLI）

替代提供商 google-gemini-cli 使用 PKCE OAuth 而非 API 密钥。这是一个非官方的集成；部分用户反馈存在账户限制。请自行承担使用风险。

环境变量：

• OPENCLAW_GEMINI_OAUTH_CLIENT_ID
• OPENCLAW_GEMINI_OAUTH_CLIENT_SECRET （或是 GEMINI_CLI_* 系列的变量）

支持的能力

环境说明

如果网关以守护进程（launchd/systemd）的方式运行，请确保 GEMINI_API_KEY 对该进程可见（例如，放在 ~/.openclaw/.env 中，或是通过 env.shellEnv 配置）。