gemini
Call Gemini 2.5 and 3 series models through RunAPI using Gemini contents clients. Use for Gemini chat, streaming, multimodal input, grounding, structured output, reasoning, or an existing compatibility client that needs the conditional reference.
Rank
62
Safety
84
Downloads
1.8k
Updated
Oct 10, 2026
Version
0.2.16
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.8K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.8K downloadsadoption · observed Oct 10, 2026
- Latest release
- 0.2.16release · observed Sep 30, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s1771k6pjxksnjws51x2htfjvd876syh:runapi-gemini- Install using `clawhub skill install s1771k6pjxksnjws51x2htfjvd876syh:runapi-gemini` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/runapi-ai/runapi-gemini before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-gemini/snapshot"
Documentation
CLAWHUB
91,004 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: gemini
description: Call Gemini 2.5 and 3 series models through RunAPI using Gemini contents clients. Use for Gemini chat, streaming, multimodal input, grounding, structured output, reasoning, or an existing compatibility client that needs the conditional reference.
documentation: https://runapi.ai/models/gemini.md
provider_page: https://runapi.ai/providers/google.md
catalog: https://runapi.ai/models.md
metadata:
openclaw:
homepage: https://runapi.ai/models/gemini
primaryEnv: GEMINI_API_KEY
requires:
env: [GEMINI_API_KEY, GEMINI_BASE_URL]
envVars:
- {name: GEMINI_API_KEY, required: true, description: RunAPI API key used by Gemini contents clients.}
- {name: GEMINI_BASE_URL, required: true, description: Set to https://runapi.ai for Gemini on RunAPI.}
---
# Gemini on RunAPI
Use Gemini contents at `https://runapi.ai` with `generateContent` or
`streamGenerateContent` as the primary protocol.
## Primary protocol recipe
### Authenticate
Set `GEMINI_API_KEY` to a RunAPI API key and the Gemini client base URL to
`https://runapi.ai`. Raw requests send the key with `x-goog-api-key`.
### Send request
```bash
curl -X POST \
"https://runapi.ai/v1beta/models/gemini-3.7-flash:streamGenerateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"role":"user","parts":[{"text":"Summarize this review."}]}]}'
```
Use `generateContent` only when the selected model supports synchronous output;
`gemini-3.7-flash` accepts only `streamGenerateContent`. For this model, native
tools are limited to `functionDeclarations` and the `googleSearch` tool with an
empty object payload;
native thinking is limited to `generationConfig.thinkingConfig.includeThoughts`
and `thinkingLevel` of `low` or `high`.
### Verify result
Require candidate content, terminal `finishReason`, and `usageMetadata`. A
stream is complete only after the terminal candidate and Usage; an HTTP 2xx
without both is incomplete.
### Stop boundaries
Correct a rejected shape once using the structured error. Retry transport once
only before any candidate or Usage and when replay is safe. Record a terminal
error and stop without changing model or protocol.
## Compatibility protocols
Load [compatibility protocols](references/compatibility-protocols.md) only when an existing client requires OpenAI-compatible Chat Completions.
## Supported models
| Model ID | Use when |
|---|---|
| `gemini-3.8-flash` | Fast text-only chat and function calling; image, audio, and file input are rejected |
| `gemini-3.7-flash` | Fast streaming chat; use native tools/search grounding only with Gemini contents |
| `gemini-3.6-flash` | Fast current-generation multimodal requests |
| `gemini-3.5-flash` | Fast multimodal and function-calling requests |
| `gemini-3.5-flash-lite` | Lightweight text generation with native Gemini streaming |
| `gemini-3.1-pro-preview` | Complex multimodal and reasoning requests |
| `gemini-3-flash-pre_meta.json
{
"ownerId": "kn70me4rk7jqjt92evshjeb5z18768g7",
"slug": "runapi-gemini",
"version": "0.2.16",
"publishedAt": 1790770605442
}references/compatibility-protocols.md
# Gemini compatibility protocol Load this reference only when an existing application already requires an OpenAI-compatible Chat Completions client. New Gemini integrations use Gemini contents from the main skill. Set `OPENAI_API_KEY` to a RunAPI key and the OpenAI client base URL to `https://runapi.ai/v1`. Call `client.chat.completions.create` with a supported exact Gemini model ID and messages. For streaming, set `stream=True` and request terminal Usage with `stream_options.include_usage`. Verify final assistant content, `finish_reason`, terminal `usage`, and `[DONE]` for SSE. Apply one evidence-backed shape correction, at most one safe pre-response transport retry, and no automatic model or protocol hopping.
skill-card.md
## Description: Guides agents in calling Gemini models through RunAPI using Gemini contents clients, with compatibility guidance for existing Chat Completions clients. This skill is ready for commercial/non-commercial use. ## Publisher: [runapi-ai](https://clawhub.ai/user/runapi-ai) ### License/Terms of Use: MIT-0 ## Use Case: Developers and agents use this skill to configure RunAPI credentials, send Gemini requests, and check streaming responses. Existing Chat Completions clients can follow its separate compatibility guidance. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Prompts and related request content are sent to RunAPI. Mitigation: Use the skill only when this disclosure is acceptable, and review request content before sending it. Risk: The RunAPI API key is sensitive. Mitigation: Keep the key in the configured environment variable and avoid exposing it in shared requests or logs. ## Reference(s): - [Gemini on RunAPI documentation](https://runapi.ai/models/gemini.md) - [RunAPI Gemini homepage](https://runapi.ai/models/gemini) - [RunAPI Google provider](https://runapi.ai/providers/google.md) - [RunAPI model catalog](https://runapi.ai/models.md) - [Compatibility protocols](references/compatibility-protocols.md) ## Skill Output: **Output Type(s):** [Guidance, Shell commands, Configuration instructions] **Output Format:** [Markdown with shell and JSON examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [Covers response-completion checks and bounded retry guidance.] ## Skill Version(s): 0.2.16 (source: ClawHub release) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/runapi-ai/skills/runapi-gemini",
"sourceUrl": "https://clawhub.ai/runapi-ai/skills/runapi-gemini",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T02:05:01.783Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-gemini/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-gemini/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T02:05:01.783Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.8K downloads",
"href": "https://clawhub.ai/runapi-ai/runapi-gemini",
"sourceUrl": "https://clawhub.ai/runapi-ai/runapi-gemini",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T02:05:01.783Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.2.16",
"href": "https://clawhub.ai/runapi-ai/runapi-gemini",
"sourceUrl": "https://clawhub.ai/runapi-ai/runapi-gemini",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-30T12:16:45.442Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-gemini/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-gemini/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.2.16",
"description": "## Added - List gemini-3.5-flash-lite for text requests through Chat Completions and native Gemini content generation. - Gemini 3.8 Flash (gemini-3.8-flash) is now listed as an available text-only Gemini model with function calling.",
"href": "https://clawhub.ai/runapi-ai/runapi-gemini",
"sourceUrl": "https://clawhub.ai/runapi-ai/runapi-gemini",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-30T12:16:45.442Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
