Google（Gemini）

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

• 提供商标识：google
• 认证方式：GEMINI_API_KEY 或 GOOGLE_API_KEY
• API：Google Gemini API
• 备用提供商：google-gemini-cli（OAuth 方式）

快速开始

1. 设置 API Key：

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

2. 设置默认模型：

{
  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 Key。这是非官方集成方式，部分用户反映可能遇到账号限制，使用前请自行评估风险。

所需环境变量：

• OPENCLAW_GEMINI_OAUTH_CLIENT_ID
• OPENCLAW_GEMINI_OAUTH_CLIENT_SECRET

（也可使用 GEMINI_CLI_* 前缀的变量名。）

功能支持

功能	是否支持
对话补全	是
图像生成	是
图像理解	是
音频转写	是
视频理解	是
网页搜索（Grounding）	是
思考/推理模式	是（Gemini 3.1+）

环境变量注意事项

如果 Gateway 以守护进程（launchd/systemd）方式运行，需确保 GEMINI_API_KEY 对该进程可见（例如写入 ~/.openclaw/.env 或通过 env.shellEnv 配置）。让你的龙虾在后台也能稳定地喝到 Gemini 的水。