Skip to main content

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 金鑰:
openclaw onboard --auth-choice google-api-key
  1. 設定預設模型:
{
  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_* 變數。)

功能

功能支援
聊天完成
影像生成
影像理解
音訊轉錄
影片理解
網頁搜尋 (Grounding)
思考 / 推理是 (Gemini 3.1+)

環境注意

如果閘道作為守護程式執行 (launchd/systemd),請確保 GEMINI_API_KEY 對該程式可用(例如,在 ~/.openclaw/.env 或透過 env.shellEnv)。