OpenClaw 接入 Gemini OAuth — 用 Google 账号直接调用 Gemini 全模型

为什么用 OAuth 而不是 API Key？

过去在 OpenClaw 中使用 Gemini，需要先到 Google AI Studio 申请 API Key、设置项目、配置计费 — 流程繁琐，新手经常卡住。OAuth 方式直接用你的 Google 账号授权，3 分钟搞定，并且可以使用 Google 给个人账号免费提供的 Gemini 额度。

• 免去 API Key 申请 — 不需要 Google Cloud 项目，不需要绑卡
• 直接用免费额度 — Gemini 2.5 Pro 每天有可观的免费调用额度
• 统一身份 — 一个 Google 账号可以同时用于 OpenClaw + Gemini CLI + AI Studio
• 授权可随时撤销 — 在 Google 账号设置里随时撤回 OpenClaw 的访问权限

授权流程（托管版）

1. 登录 openclawlaunch.com/dashboard。
2. 进入实例设置 → Models → 选择 Gemini 系列模型（如 gemini-2.5-pro）。
3. 在 Provider 下拉里选「Google OAuth」而不是「API Key」。
4. 点击「Connect Google Account」按钮，会跳转到 Google 授权页面。
5. 选择你的 Google 账号，同意授权 OpenClaw Launch 访问 Gemini API。
6. 授权完成会自动跳回 dashboard，配置已保存。可以直接在任何已接入的频道里测试 Gemini。

授权流程（自建用户）

自建 OpenClaw 用户需要先用 openclaw login google 命令登录：

docker exec -it openclaw openclaw login google
# 终端会输出一个 URL，用浏览器打开并完成授权
# 授权成功后凭据写入 ~/.openclaw/credentials/google.json

然后在 ~/.openclaw/openclaw.json 里配置 Gemini provider：

{
  "models": {
    "providers": {
      "google": {
        "auth": "oauth",
        "credentialsPath": "~/.openclaw/credentials/google.json"
      }
    },
    "default": "google/gemini-2.5-pro"
  }
}

保存后 docker restart openclaw，启动日志中看到 google provider ready (auth=oauth) 说明成功。

支持的 Gemini 模型

• google/gemini-2.5-pro — 旗舰模型，复杂推理、多模态
• google/gemini-2.5-flash — 快速响应版本，性价比最高
• google/gemini-2.5-flash-thinking — 带思考链的 Flash 版本
• google/gemini-2.0-flash — 上一代 Flash，更便宜

模型 ID 必须带 google/ 前缀，参考 OpenClaw 模型列表。

免费额度说明

通过 OAuth 接入 Gemini，使用的是 Google 给个人账号的免费 quota，目前的额度（截至 2026 年 4 月）大致是：

• Gemini 2.5 Pro：每分钟 ~5 次请求，每天 ~50 次请求
• Gemini 2.5 Flash：每分钟 ~15 次请求，每天 ~1,500 次请求
• 个人 AI 助手日常使用通常用不完免费额度

如果需要更高额度，可以切换回 API Key 方式并在 Google AI Studio 升级到付费 tier，或者使用 Qwen、DeepSeek 等国内模型作为补充。

常见报错

授权回调失败 / redirect_uri_mismatch

说明 OAuth 回调 URL 不匹配。托管版用户重新点一次 Connect 按钮即可；自建用户检查 openclaw login google 命令打印的回调 URL 是否能在浏览器中正确访问（通常是 http://localhost:9876/callback，需要本机访问）。

403 PERMISSION_DENIED / Gemini API has not been used

当前 Google 账号没有启用 Gemini API。访问 Google AI Studio，登录同一个账号，接受服务条款即可激活。

账号被永久停权后还能用吗？

不能。如果 Google 账号本身被封（详见 OpenClaw 用户被 Google 永久停权后怎么办），OAuth 方式自然无法使用。需要换一个未被封的 Google 账号重新授权，或切换到其他模型 provider。

429 RESOURCE_EXHAUSTED

达到当前 quota 上限。等待几分钟后重试，或在 OpenClaw 配置里加 fallback 模型（注意：付费订阅用户建议不要配 fallback，只让付费模型生效）。

OAuth vs API Key 怎么选？

• 个人轻度使用 → OAuth，免去申请，免费额度够用
• 团队 / 高并发 → API Key + 付费 tier，无 quota 限制
• 多账号轮询 → API Key 更灵活，方便管理多个 key
• 不想暴露 API Key 给容器 → OAuth 凭据可以严格通过文件挂载控制