gpt
Call GPT generation and OpenAI text embedding models through RunAPI using OpenAI-compatible clients. Use for chat, Responses, embeddings, streaming, tools, vision, or an existing compatibility client that needs the conditional reference.
Rank
62
Safety
84
Downloads
1.7k
Updated
Oct 10, 2026
Version
0.2.17
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.7K 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.7K downloadsadoption · observed Oct 10, 2026
- Latest release
- 0.2.17release · observed Sep 30, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s1771k6pjxksnjws51x2htfjvd876syh:runapi-gpt- Install using `clawhub skill install s1771k6pjxksnjws51x2htfjvd876syh:runapi-gpt` 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-gpt before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-gpt/snapshot"
Documentation
CLAWHUB
96,734 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: gpt
description: Call GPT generation and OpenAI text embedding models through RunAPI using OpenAI-compatible clients. Use for chat, Responses, embeddings, streaming, tools, vision, or an existing compatibility client that needs the conditional reference.
documentation: https://runapi.ai/models/gpt.md
provider_page: https://runapi.ai/providers/openai.md
catalog: https://runapi.ai/models.md
metadata:
openclaw:
homepage: https://runapi.ai/models/gpt
primaryEnv: OPENAI_API_KEY
requires:
env: [OPENAI_API_KEY, OPENAI_BASE_URL]
envVars:
- {name: OPENAI_API_KEY, required: true, description: RunAPI API key used by OpenAI-compatible clients.}
- {name: OPENAI_BASE_URL, required: true, description: Set to https://runapi.ai/v1 for GPT on RunAPI.}
---
# GPT on RunAPI
Use OpenAI-compatible clients at `https://runapi.ai/v1` as the primary protocol.
## Primary protocol recipe
### Authenticate
Set `OPENAI_API_KEY` to a RunAPI API key and `OPENAI_BASE_URL` to `https://runapi.ai/v1`.
### Send request
```python
from openai import OpenAI
client = OpenAI(api_key="YOUR_RUNAPI_TOKEN", base_url="https://runapi.ai/v1")
response = client.responses.create(model="gpt-5.5", input="Summarize this review.")
print(response.output_text)
print(response.usage)
```
Use `client.chat.completions.create` for `gpt-5.2`, which does not accept
Responses. Use Responses for `gpt-5.*-pro`. Use `client.embeddings.create` only
with the three embedding model IDs below. For streaming Responses, set
`stream=True` and consume through one usage-bearing `response.completed`
followed by `[DONE]`.
For `gpt-5.6-luna`, `gpt-5.6-sol`, and `gpt-5.6-terra`, start with text input,
sync or SSE transport, parameterized custom functions, and automatic prompt
caching. Add reasoning controls, multimodal input, hosted tools, or
continuation state only when the current RunAPI contract verifies that shape.
### Verify result
Responses require final output, `response.completed`, and `usage`. Chat requires
final assistant content, `finish_reason`, and `usage`. Embeddings require one
numeric vector per input and response `usage`.
### Stop boundaries
Correct a rejected shape once using the current error and endpoint contract.
Retry transport once only before any response or Usage and when replay is safe.
Record a terminal error and stop without changing model, endpoint, or protocol.
Keep embedding models on `/v1/embeddings`.
## Compatibility protocols
Load [compatibility protocols](references/compatibility-protocols.md) only when an existing client requires Anthropic Messages or Gemini contents.
## Live audio
`gpt-live-1` is available only on the dedicated Live transport. Use WebRTC
with `POST /v1/live/webrtc` and a client SDP offer, or WebSocket with
`GET /v1/live/websocket` and a first `session.start` frame. Live sessions may
delegate backend work through `delegation.type: responses` or return function
work through `delegation.type: client`. Responses delegatio_meta.json
{
"ownerId": "kn70me4rk7jqjt92evshjeb5z18768g7",
"slug": "runapi-gpt",
"version": "0.2.17",
"publishedAt": 1790770569667
}references/compatibility-protocols.md
# GPT compatibility protocols Load this reference only for an existing Anthropic Messages or Gemini contents client. Embedding models remain on `/v1/embeddings` and do not use these compatibility protocols. For Messages, use base URL `https://runapi.ai`, a RunAPI key, a supported exact generation model ID, `max_tokens`, and messages. Verify final content, `stop_reason`, and `usage`; streaming ends at `message_stop`. For Gemini contents, set `RUNAPI_MODEL` to a supported exact model ID and use `https://runapi.ai/v1beta/models/$RUNAPI_MODEL:generateContent` or `streamGenerateContent` with `x-goog-api-key`. Verify candidates, `finishReason`, and `usageMetadata`. 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 using OpenAI-compatible clients to call GPT generation and text embedding models through RunAPI. 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 clients and select supported requests for GPT chat, Responses, embeddings, streaming, tools, vision, or live audio. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Model requests send prompts and other supplied data to RunAPI for processing. Mitigation: Use this skill only when RunAPI is an approved processor; check account policies and data-retention terms before sending secrets, regulated data, or private documents. Risk: A RunAPI API key is required for client requests. Mitigation: Keep the key in the OPENAI_API_KEY environment variable rather than embedding it in examples or shared files. ## Reference(s): - [GPT on RunAPI documentation](https://runapi.ai/models/gpt.md) - [RunAPI OpenAI provider](https://runapi.ai/providers/openai.md) - [RunAPI model catalog](https://runapi.ai/models.md) - [GPT on RunAPI model page](https://runapi.ai/models/gpt) - [Compatibility protocols](references/compatibility-protocols.md) ## Skill Output: **Output Type(s):** [Guidance, Code, Configuration instructions] **Output Format:** [Markdown with Python examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [Request shapes and model support depend on the RunAPI endpoint and current contract.] ## Skill Version(s): 0.2.17 (source: ClawHub release metadata) ## 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-gpt",
"sourceUrl": "https://clawhub.ai/runapi-ai/skills/runapi-gpt",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T04:07:23.563Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-gpt/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-gpt/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T04:07:23.563Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.7K downloads",
"href": "https://clawhub.ai/runapi-ai/runapi-gpt",
"sourceUrl": "https://clawhub.ai/runapi-ai/runapi-gpt",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T04:07:23.563Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.2.17",
"href": "https://clawhub.ai/runapi-ai/runapi-gpt",
"sourceUrl": "https://clawhub.ai/runapi-ai/runapi-gpt",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-30T12:16:09.667Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-gpt/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-gpt/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.2.17",
"description": "## Added - List gpt-5-pro for text-only Responses requests. - Add GPT-6.1 Sol with the same protocol and function-tool support as the other GPT models. ## Fixed - Keep model compatibility guidance separate from the generated model roster.",
"href": "https://clawhub.ai/runapi-ai/runapi-gpt",
"sourceUrl": "https://clawhub.ai/runapi-ai/runapi-gpt",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-30T12:16:09.667Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
