OpenClaw 接入 Gemini 3.1 Flash：谷歌最新模型详细配置步骤-人工智能-PHP中文网

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

openclaw 接入 gemini 3.1 flash：谷歌最新模型详细配置步骤

图：openclaw 接入 gemini 3.1 flash：谷歌最新模型详细配置步骤

谷歌的 Gemini 系列是 OpenClaw 社区中使用量增长最快的 AI 模型之一——得益于 Google AI Studio 提供的慷慨免费额度（每天 1500 次请求，完全无需绑定信用卡），Gemini 已成为新手体验 OpenClaw、零成本搭建个人 AI 助手的首选入口。

Gemini 3.1 Flash（在 OpenClaw 中的模型 ID 为 google/gemini-3-flash-preview）是目前性价比最高的 Gemini 模型——100 万 Token 上下文、66K Token 超长输出、原生多模态，并内置网页搜索工具，价格仅为 $0.50/百万输入 Token。本文提供完整配置教程。更多资源请访问 OpenClaw 中文版官网。

一、Gemini 3.1 Flash 核心优势

在正式开始配置前，有必要理解为什么 Gemini 3.1 Flash 值得接入 OpenClaw：

66K Token 输出上限：相比早期 Flash 模型仅 8K 输出，这是最关键的升级。意味着 AI 可以在一次调用中生成完整的代码文件、长篇报告或详细分析，不会被截断
100 万 Token 上下文：可以将整个代码仓库、几百页文档一次性送入分析，是 Claude Sonnet 200K 上下文的 5 倍
原生多模态：支持图片、视频、URL 内容直接作为输入，无需额外配置
内置网页搜索与 URL 上下文：AI 可以主动搜索最新信息，不依赖第三方搜索插件
SWE-bench 78%：在编程评测上甚至超越了 Gemini 3 Pro（76.2%），对代码任务友好
免费额度充足：每分钟 15 次请求、每天 1500 次请求（免费层），轻度个人使用无需付费

二、关键说明：模型 ID 命名规则

Gemini 的模型 ID 命名方式容易混淆，在配置 OpenClaw 前务必理解以下对应关系：

谷歌官方名称	OpenClaw 正确 Model ID	说明
Gemini 3 Flash / Gemini 3.1 Flash	`google/gemini-3-flash-preview`	✅ 正确，OpenClaw 内置支持
Gemini 3.1 Pro	`google/gemini-3.1-pro-preview`	✅ 正确（v2026.3.7+ 支持）
Gemini 3.1 Flash Lite	`google/gemini-3.1-flash-lite-preview`	✅ 正确（v2026.3.7+ 支持）
Gemini 2.0 Flash	`google/gemini-2.0-flash`	✅ 最便宜，有免费额度
Gemini 2.5 Flash	`google/gemini-2.5-flash`	✅ 已支持

三、获取 Google AI Studio API Key

访问 aistudio.google.com/apikey，用 Google 账号登录
点击「Create API Key」
选择一个 Google Cloud 项目（如果没有，创建一个新项目）
复制生成的 API Key（格式：AIzaSy...）
免费账户无需绑定信用卡即可使用，如需更高限额，在 Google Cloud Console 中为项目开启计费即可

免费额度详情（2026 年 4 月）

模型	免费 RPM（每分钟请求）	免费 RPD（每日请求）
Gemini 3 Flash（gemini-3-flash-preview）	15 RPM	1,500 RPD
Gemini 3.1 Flash Lite（gemini-3.1-flash-lite-preview）	15 RPM	1,500 RPD
Gemini 2.0 Flash	60 RPM	1,500 RPD
Gemini 3.1 Pro（gemini-3.1-pro-preview）	5 RPM	500 RPD

对于轻度个人使用，每天 1500 次请求已绰绰有余。如果是 24 小时运行 Heartbeat 任务的场景，建议开通付费计划以避免额度耗尽导致服务中断。

四、方式一：引导向导快速配置

<code># 通过引导向导配置 Gemini API Keyopenclaw onboard --auth-choice gemini-api-key</code>

向导中依次操作：

粘贴 API Key（AIzaSy...）
选择默认模型：选择 Gemini 3 Flash Preview（即 gemini-3-flash-preview）
完成其他渠道和技能配置

向导完成后验证：

<code>openclaw models list | grep google# 应看到：google/gemini-3-flash-previewtext+image1024knoyes</code>

五、方式二：手动编辑 openclaw.json（推荐完整配置）

第一步：设置环境变量

在 ~/.openclaw/.env 中添加（OpenClaw 支持多个 Key 的轮换）：

<code># 单个 KeyGEMINI_API_KEY=AIzaSy你的密钥# 多 Key 轮换（达速率限制时自动切换）GEMINI_API_KEY_1=AIzaSy密钥1GEMINI_API_KEY_2=AIzaSy密钥2# 也支持：GEMINI_API_KEYS、GOOGLE_API_KEY 作为回退</code>

第二步：配置 openclaw.json

<code>{"env": {"GEMINI_API_KEY": "AIzaSy你的密钥"},"agents": {"defaults": {"model": {"primary": "google/gemini-3-flash-preview","fallbacks": ["google/gemini-3.1-pro-preview","google/gemini-2.5-flash"]},"models": {"google/gemini-3-flash-preview": {"alias": "flash"},"google/gemini-3.1-pro-preview": {"alias": "pro"},"google/gemini-3.1-flash-lite-preview": {"alias": "flash-lite"},"google/gemini-2.5-flash": {"alias": "25flash"},"google/gemini-2.0-flash": {"alias": "20flash"}}}}}</code>

如果需要显式指定端点（用于自定义代理或 Vertex AI 路由），可以添加自定义服务商块：

<code>{"models": {"mode": "merge","providers": {"google": {"baseUrl": "https://generativelanguage.googleapis.com/v1beta","apiKey": "${GEMINI_API_KEY}","api": "google-generative-ai","models": [{"id": "gemini-3-flash-preview","name": "Gemini 3 Flash（默认推荐）","input": ["text", "image"],"contextWindow": 1000000,"maxTokens": 65535},{"id": "gemini-3.1-pro-preview","name": "Gemini 3.1 Pro（复杂推理）","input": ["text", "image"],"contextWindow": 1000000,"maxTokens": 65535},{"id": "gemini-3.1-flash-lite-preview","name": "Gemini 3.1 Flash Lite（高量轻任务）","input": ["text", "image"],"contextWindow": 1000000,"maxTokens": 65535},{"id": "gemini-2.5-flash","name": "Gemini 2.5 Flash（大文档分析专用）","input": ["text", "image"],"contextWindow": 1000000,"maxTokens": 8192},{"id": "gemini-2.0-flash","name": "Gemini 2.0 Flash（免费额度最大）","input": ["text", "image"],"contextWindow": 1000000,"maxTokens": 8192}]}}}}</code>

第三步：重启并验证

<code>openclaw daemon restart# 确认模型已加载openclaw models list | grep google# 运行健康检查openclaw doctor# 测试请求（发送一条消息，观察是否有 Gemini 响应）# 或通过别名切换确认：# /model flash</code>

六、方式三：Gemini CLI OAuth（免 API Key，个人使用）

如果你已安装并登录了 Google Gemini CLI，OpenClaw 支持通过 OAuth 方式接入，无需管理 API Key：

Openclaw Soul Publish

OpenClaw 自我进化框架一键部署。安装宪法(AGENTS.md)、可进化灵魂(SOUL.md)、心跳系统、PARA三层记忆架构、目标管理，并通过场景化对话引导用户定义 Agent 性格。自动配置 EvoClaw（审批制进化）和 Self-Improving Agent（自主学习）。触发场景："setup o...

下载

<code># 确认 Gemini CLI 已安装并登录gemini --versiongemini "hello" # 测试 CLI 是否正常工作# 在 OpenClaw 中登录 Gemini CLI provideropenclaw models auth login --provider google-gemini-cli --set-default</code>

登录后会打开浏览器完成 Google OAuth 授权，token 存储在 Gateway 的 auth profiles 中。

<code># 使用 Gemini CLI 作为后端的模型引用格式"primary": "google-gemini-cli/gemini-3-flash-preview"</code>

七、Gemini 全系列模型选型指南

模型 ID	输入价格	输出价格	最大输出	适用场景
gemini-3-flash-preview	$0.50/M	$3.00/M	66K Token	首选：代码生成、长文档、日常任务、内置搜索
gemini-3.1-pro-preview	$2.00/M	$12.00/M	66K Token	复杂推理、多步调试、架构决策（按需切换）
gemini-3.1-flash-lite-preview	$0.25/M	$1.50/M	65K Token	高频心跳任务、轻量自动化（成本最低）
gemini-2.5-flash	$0.63/M	$2.50/M	8K Token（！）	大文档分析（输出需求少的场景）
gemini-2.0-flash	$0.10/M	$0.40/M	8K Token（！）	测试、轻量任务、免费额度最大（60 RPM）

实用建议：gemini-2.5-flash 和 gemini-2.0-flash 的输出上限仅 8K Token，适合需要读取大量内容但输出简短的场景（如文档问答、代码审查评论）。如果需要生成较长内容，只选 Gemini 3 系列模型。

八、Gemini 在 OpenClaw 的实战场景

场景一：大文档处理（1M 上下文的实际用法）

<code># 将一个 400 页 PDF 报告全文送入分析（Gemini 独有优势）帮我分析 workspace/annual-report-2025.pdf 中的财务数据，列出三个最值得关注的风险点和两个增长机会# Gemini 3 Flash 可以在一次调用中处理完整文档# 而不需要分块处理</code>

场景二：代码生成（66K 输出的优势）

<code># 生成完整的模块代码（不担心截断）/model flash帮我实现一个完整的 JWT 认证中间件，包括：- 用户注册和登录接口- Token 生成和验证逻辑- 刷新 Token 机制- 单元测试文件# Gemini 3 Flash 在单次输出中可以生成数千行代码</code>

场景三：多模型混合策略

<code># 日常任务 → Gemini 3 Flash（平衡）/model flash # 成本低、速度快、够用# 复杂推理 → Gemini 3.1 Pro（精准）/model pro# 关键任务、不容出错# 批量轻任务 → Flash Lite（最省成本）/model flash-lite # 心跳任务、通知处理# 接近免费的测试 → Gemini 2.0 Flash/model 20flash # 60 RPM 免费额度</code>