跳转到内容

Google (Gemini)

Google 插件通过 Google AI Studio 提供对 Gemini 模型的访问,此外还提供图像生成、媒体理解(图像/音频/视频)以及通过 Gemini Grounding 进行的网络搜索。

  • 提供商: google
  • 认证: GEMINI_API_KEYGOOGLE_API_KEY
  • API: Google Gemini API
  • 替代提供商: google-gemini-cli (OAuth)
  1. 设置 API 密钥:
Terminal window
openclaw onboard --auth-choice google-api-key
  1. 设置默认模型:
{
agents: {
defaults: {
model: { primary: "google/gemini-3.1-pro-preview" },
},
},
}
Terminal window
openclaw onboard --non-interactive \
--mode local \
--auth-choice google-api-key \
--gemini-api-key "$GEMINI_API_KEY"

一个替代提供商 google-gemini-cli 使用 PKCE OAuth 而不是 API 密钥。这是一个非官方集成;一些用户报告了账户限制。使用风险自负。

环境变量:

  • OPENCLAW_GEMINI_OAUTH_CLIENT_ID
  • OPENCLAW_GEMINI_OAUTH_CLIENT_SECRET

(或者 GEMINI_CLI_* 变体。)

功能支持
聊天补全
图像生成
图像理解
音频转录
视频理解
网络搜索 (Grounding)
思考/推理是 (Gemini 3.1+)

如果 Gateway(网关) 作为守护进程 运行,请确保 GEMINI_API_KEY 对该进程可用(例如,在 ~/.openclaw/.env 中或通过 env.shellEnv)。