Skip to content

Gemini 相关问题

Gemini CLI 现状与建议

现状

Gemini CLI 在生态适配上仍有不少问题:模型调用偶发失败、图片粘贴异常等,因此不建议把 Gemini-3 直接接到 Gemini CLI 长期跑

更推荐的方式

  • 优先用 Cline / Roo Code 等第三方 VSCode 插件
  • 必须用 Gemini CLI 时,建议走 Antigravity 分组(兼容性更好)

重要提示

  • Antigravity 分组的 Gemini-3 模型名可能和其他分组不同,请查 模型分组介绍 避免"无可用渠道" / "模型不存在"
  • 第三方工具调用 OpusClaw 时,选 "OpenAI Response" 请求格式
  • Antigravity 分组通常不自带联网能力,需要配合 MCP 工具实现联网搜索

在 Cline 中使用 Gemini-3

软件要求

软件版本
VSCode1.80.0+

步骤 1:创建 Gemini 分组令牌

参考 创建 API 令牌,为 gemini 分组创建令牌,复制 API Key。

步骤 2:安装 Cline 插件

VSCode → Ctrl+Shift+X → 搜索 Cline → 安装。

步骤 3:打开 Cline

  • 左侧栏点 Cline 图标
  • Ctrl+Shift+P 输入 Cline: Open 回车

步骤 4:首次配置

点击 API Configuration,填:

配置项
API ProviderOpenAI-compatible
Base URLhttps://api.opusclaw.me/v1
API Key(粘贴 gemini 分组令牌)
Model IDgemini-3.1-pro-previewgemini-3-flash

步骤 5:完成

点右上角 Done 保存,即可开始用 Gemini 模型。

todo

常见错误

现象通常原因
model not found令牌不是 gemini 分组,或者模型 ID 拼错
no available channel上游通道临时不可用,稍后重试
图片粘贴失败Gemini CLI 已知问题,改用 Cline / Cherry Studio
401 UnauthorizedAPI Key 不对 / 已过期

接下来

OpusClaw