openclaw onboard --auth-choice google-api-key
像在向导里明确说：“我要接 Gemini，请收下 API key。”
Providers 导读
接入 Google Gemini：API Key 还是 OAuth？
先选认证方式：API Key（适合快速上手）或 OAuth（适合生产环境）。配置完别忘了在模型名里加上 `google/` 前缀，比如 `google/gemini-3.1-pro-preview`。Gemma 4 的 thinking 模式默认映射为 `MINIMAL`，想关掉要显式设 `off`。
先讲这一页到底在解决什么
接入 Google Gemini：API Key 还是 OAuth？
先选认证方式：API Key（适合快速上手）或 OAuth（适合生产环境）。配置完别忘了在模型名里加上 `google/` 前缀，比如 `google/gemini-3.1-pro-preview`。Gemma 4 的 thinking 模式默认映射为 `MINIMAL`，想关掉要显式设 `off`。
第一步
🔑 主路还是 API key：先把 Gemini 的门票交出去
Google 这页的主路非常直接。你给 key，OpenClaw 就能去找 Gemini。
GEMINI_API_KEY / GOOGLE_API_KEY
这两个像同一串钥匙的两个标签。官方允许你拿这两种名字中的任意一种来交钥匙。
默认模型
google/gemini-3.1-pro-preview 像“先请 Gemini 家里这位比较全能的大老师来值班”。
非交互式命令
那条带 --gemini-api-key 的命令，像你把登记卡一次填完，适合脚本和自动部署。
第二步
🎨 Gemini 的厉害之处，不是只会聊天，而是“感官很多”
官方把能力表列得很平，但真正好懂的说法是：Gemini 不是只会读字，它还有眼睛、耳朵，还会出去帮你找资料。
💬 Chat completions
会聊天，这是最基础的一项。
🖼 Image generation / understanding
既能看图，也能画图。像又会欣赏画，又能自己动手画。
🎧 Audio / 🎬 Video
会听声音、也能看视频。像不只是会读信，还能看录像、听录音。
🌍 Web search grounding
像它不只靠脑内记忆，还能真的跑出去查资料，再把答案带回来。
第三步
🧠 Thinking / reasoning，就是“Gemini 会不会多想几步”
官方表格最后一列写的是支持 thinking/reasoning。翻成人话，就是 Gemini 3.1 往上，已经不只是会答，还会更认真推理。
🧩 普通回答
像有人问你现在几点，你看一眼就答。
🔍 reasoning
像有人给你一道绕一点的题，你要先摆积木、排步骤、再出答案。
📌 这里别想歪
这不是说“Google 页又有一套特殊命令”，而是在提醒你：Gemini 这类模型本身就带更强的推理能力。
🎈 一句话
Gemini 不只是多模态，还会思考。
第四步
🪪 那条 OAuth 小路，像“借别的证件进门”，官方没有把它当主路
Google 这页专门把 google-gemini-cli 拎出来说，是因为它跟 API key 不是一回事。
google-gemini-cli像借 Gemini CLI 的 OAuth 身份来进门，而不是拿正式 API key。
⚠️ 为什么官方提醒“有风险”
因为这条不是最稳、最标准、最被官方公开扶正的路线。有用户会碰到账户限制，所以文档明确叫你自己承担风险。
OPENCLAW_GEMINI_OAUTH_CLIENT_ID这些环境变量像你要先准备一整套 OAuth 证件材料，不像 API key 那么直截了当。
🎈 真正建议
如果你只是想把 Google 接稳，先走 API key 主路。别一上来就钻旁门。
第五步
🏠 还是那句老话：后台值班的 Gateway 也得摸得到钥匙
官方每个 provider 页都反复提醒这一句，不是啰嗦，而是这真的是最常见坑。
GEMINI_API_KEY 放在你当前终端里，不代表守护进程也能看到。真正长期跑的 Gateway，要把钥匙放到它也能拿到的地方，比如 ~/.openclaw/.env 或对应的环境导入配置。
最后总结
🎈 把 Google 这页压成一句最好记的话
Gemini 这条线最值钱的地方，是一把 API key 能接上一个会聊天、会看图、会听音、会看视频、还会出去查资料的多面手；CLI OAuth 那条路只是旁路，不是主路。
如果你想看“一把钥匙连很多模型商店”的玩法，接着看 OpenRouter 会很顺。