Google · 文字

OpenClaw x Gemini

Gemini 是 Google 的旗艦多模態 LLM，提供 Flash（快速）與 Pro（前沿推理）變體。透過 RunAPI，所有 Gemini 模型共用相同的 API 格式與計費方式。

11 variants 起價 $0.10 / 百萬 tokens 可商用
取得 API Key 查看 OpenClaw 文件

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任務合適時使用 gemini-2.5-flash：針對速度／成本最佳化；1M 上下文；上一代基準模型。

You have access to RunAPI chat models for Gemini.

Available Gemini models:
- gemini-2.5-flash: 針對速度／成本最佳化；1M 上下文；上一代基準模型
  chat endpoints: /v1/chat/completions
- gemini-2.5-flash-lite: Gemini 2.5 Flash-Lite；100 萬上下文，預設關閉思考；OpenAI 相容 Chat Completions
  chat endpoints: /v1/chat/completions
- gemini-2.5-pro: 2.5 世代中推理能力最強；1M 上下文
  chat endpoints: /v1/chat/completions
- gemini-3-flash-preview: gemini-3-flash-preview
  chat endpoints: /v1/chat/completions, /v1beta/models/gemini-3-flash-preview:streamGenerateContent
- gemini-3.1-flash-lite: Gemini 3.1 Flash-Lite；100 萬上下文，可調整思考；透過 OpenAI 相容 Chat Completions 傳送文字請求
  chat endpoints: /v1/chat/completions
- gemini-3.1-pro-preview: gemini-3.1-pro-preview
  chat endpoints: /v1/chat/completions
- gemini-3.5-flash: 快速的多模態串流，適用於大量的正式環境工作負載
  chat endpoints: /v1/chat/completions, /v1beta/models/gemini-3.5-flash:streamGenerateContent
- gemini-3.5-flash-lite: 輕量級 Gemini，支援 Chat Completions 與原生內容串流文字生成
  chat endpoints: /v1/chat/completions, /v1beta/models/gemini-3.5-flash-lite:streamGenerateContent
- gemini-3.6-flash: 面向正式環境工作流程的快速多模態對話、工具呼叫與串流輸出
  chat endpoints: /v1/chat/completions, /v1beta/models/gemini-3.6-flash:streamGenerateContent
- gemini-3.7-flash: 支援用量回報的快速串流對話與原生內容輸出
  chat endpoints: /v1/chat/completions, /v1beta/models/gemini-3.7-flash:streamGenerateContent
- gemini-3.8-flash: 支援函式呼叫與原生內容串流輸出的文字對話，適合 Agent 工作負載
  chat endpoints: /v1/chat/completions, /v1beta/models/gemini-3.8-flash:streamGenerateContent

Use the model ID and chat endpoint that match the user's request.
Example request: 分析這個程式碼庫，提出三項效能改善建議，並附上修改前後的範例。
Verify the active model with: openclaw models status;openclaw models set runapi/<model-id>

公開版本與端點

模型 ID 端點 起始價格 模型目錄
gemini-2.5-flash
/v1/chat/completions
$0.30 / 百萬 tokens 模型詳情
gemini-2.5-flash-lite
/v1/chat/completions
$0.10 / 百萬 tokens 模型詳情
gemini-2.5-pro
/v1/chat/completions
$1.25 / 百萬 tokens 模型詳情
gemini-3-flash-preview
/v1/chat/completions /v1beta/models/gemini-3-flash-preview:streamGenerateContent
$0.30 / 百萬 tokens 模型詳情
gemini-3.1-flash-lite
/v1/chat/completions
$0.25 / 百萬 tokens 模型詳情
gemini-3.1-pro-preview
/v1/chat/completions
$1.00 / 百萬 tokens 模型詳情
gemini-3.5-flash
/v1/chat/completions /v1beta/models/gemini-3.5-flash:streamGenerateContent
$0.90 / 百萬 tokens 模型詳情
gemini-3.5-flash-lite
/v1/chat/completions /v1beta/models/gemini-3.5-flash-lite:streamGenerateContent
$0.15 / 百萬 tokens 模型詳情
gemini-3.6-flash
/v1/chat/completions /v1beta/models/gemini-3.6-flash:streamGenerateContent
$0.75 / 百萬 tokens 模型詳情
gemini-3.7-flash
/v1/chat/completions /v1beta/models/gemini-3.7-flash:streamGenerateContent
$0.45 / 百萬 tokens 模型詳情
gemini-3.8-flash
/v1/chat/completions /v1beta/models/gemini-3.8-flash:streamGenerateContent
$0.45 / 百萬 tokens 模型詳情

驗證

輪詢，直到 Task 進入終態

選擇 <model-id> 後產生驗證命令。

設定

指南端點: <endpoint>

選擇 <model-id> 後，依端點的公開輸入契約產生請求。
使用流程

三步開始使用

  1. 選擇模型 ID

    選擇公開模型 ID，並查看其端點與目前起始價格。

  2. 設定 RunAPI

    為此 Agent 新增 Provider 設定。

  3. 驗證結果

    執行下方 Agent 狀態與模型選擇命令。

使用 OpenClaw + Gemini 可以打造什麼

  • 多模態應用

    在文字提示詞之外傳送圖片、PDF、音訊或影片，讓 Gemini 在一次呼叫中完成分析、描述或結構化資料擷取。

  • 長文件分析

    在一次請求中把大型程式碼庫、法律文件集或研究資料交給 Gemini 進行分析和摘要。

  • 快速的 Agent 迴圈

    在重視速度的工具呼叫鏈中使用 Gemini 的 Flash 版本，此時延遲比極致推理品質更重要。

為什麼透過 RunAPI + OpenClaw 使用 Gemini

  • 11 個變體，一個 API 金鑰

    透過一個 RunAPI 連線選擇可用的模型變體，無需變更現有整合。

  • 清楚的用量價格

    送出請求前查看目錄中的目前價格，無需訂閱或最低消費。

  • 直接回傳結果

    同步呼叫會在同一個回應中回傳結果，Agent 不需輪詢工作即可直接使用。

OpenClaw + Gemini 常見問題

在 OpenClaw 中使用 Gemini 需要 Google Cloud 專案嗎？

不需要。RunAPI 透過相容 OpenAI 的端點提供 Gemini，只要一組 RunAPI API 金鑰，不需要 Google Cloud 專案、服務帳戶或 Vertex AI 計費。

什麼時候用 Gemini Flash，什麼時候用 Pro？

Flash 版本更快、更便宜，適合 Agent 迴圈、分類和工具呼叫；Pro 版本適合複雜推理和長脈絡分析。

透過 RunAPI 使用 Gemini 支援函式呼叫嗎？

支援。RunAPI 會把相容 OpenAI 的 tools 和 tool_choice 傳給 Gemini，Gemini 會在助理訊息中回傳工具呼叫。OpenClaw 的處理方式與其他模型的工具呼叫相同。

應該使用哪個模型 ID？

從版本表選擇公開模型 ID。每個 ID 可用的端點都列在對應資料列。

本指南會設定聊天模型嗎？

會。此 Model Line 支援面向用戶端的 LLM 協定。

開始在 OpenClaw 中使用 Gemini

取得 API Key 閱讀快速入門

正在與團隊一起打造？

我們可以協助企業接入、整合與技術問題。

聯絡我們