runapi-cli
Use the RunAPI CLI for one-off artifacts and results, or RunAPI's standard x402 REST flow for wallet-funded Task calls without an API key. Use when an agent needs to discover models or prices, create a paid Task, poll its result, or run a supported CLI service. Use an SDK for app or production integration. Skill: runapi-cli Owner: runapi-ai Summary: Use the RunAPI CLI for one-off artifacts and results, or RunAPI's standard x402 REST flow for wallet-funded Task calls without an API key. Use when an agent needs to discover models or prices, create a paid Task, poll its result, or run a supported CLI service. Use an SDK for app or production integration. Tags: latest:0.3.1 Version history: v0.3.1 | 2026-09-28T05:47:14.718
Rank
62
Safety
84
Downloads
1.7k
Updated
Oct 10, 2026
Version
0.3.1
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.3.1release · observed Sep 28, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s1771k6pjxksnjws51x2htfjvd876syh:runapi-cli- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-cli/snapshot"
Documentation
CLAWHUB
144,421 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
---
name: runapi-cli
description: Use the RunAPI CLI for one-off artifacts and results, or RunAPI's standard x402 REST flow for wallet-funded Task calls without an API key. Use when an agent needs to discover models or prices, create a paid Task, poll its result, or run a supported CLI service. Use an SDK for app or production integration.
documentation: https://runapi.ai/models.md
catalog: https://runapi.ai/models.md
metadata:
openclaw:
homepage: https://runapi.ai/models
primaryEnv: RUNAPI_API_KEY
requires:
bins:
- runapi
install:
- kind: brew
formula: runapi-ai/tap/runapi
bins:
- runapi
envVars:
- name: RUNAPI_API_KEY
required: false
description: Optional RunAPI API key; agents should prefer environment auth or saved shared config for headless use. Browser login can be completed with `runapi login` or the MCP `login` tool.
---
# RunAPI CLI
The `runapi` CLI executes one-off artifacts or results only for services in its
installed command catalog. An app, backend, worker, library, or production code
integration uses a RunAPI SDK instead.
## Choose route
Use the CLI for a one-off artifact or result. Use an SDK for an app, backend,
worker, library, or production code. Before composing a service command,
discover the installed command catalog with `runapi --help`; proceed only when
it lists the service. An absent service routes to its SDK or public API contract,
not to a guessed CLI command.
## Install
| Target | Command |
|---|---|
| macOS / Linux (interactive) | `brew install runapi-ai/tap/runapi` |
| Server / CI (headless) | `curl -fsSL https://runapi.ai/cli/install.sh \| sh` |
The installer detects OS and architecture (Linux and macOS, amd64 and arm64), verifies a SHA-256 checksum from `https://runapi.ai/cli/latest.json`, and refuses to write the binary if verification fails.
## Authentication
Check the current state first:
```shell
runapi auth status
```
| Source | How |
|---|---|
| Environment (agent/headless default) | Read `RUNAPI_API_KEY` from the environment |
| Saved config (agent/server/CI) | `printf '%s' "$RUNAPI_API_KEY" \| runapi auth import-token --token -` (writes `~/.config/runapi/config.json` with mode 0600) |
| Browser login (interactive fallback) | `runapi login` in a terminal, or the MCP `login` tool from an MCP host |
`RUNAPI_BASE_URL` overrides the default base URL.
The RunAPI MCP Server reads the same `~/.config/runapi/config.json` as the CLI. After `runapi login` or the MCP `login` tool completes, authenticated MCP tools can use the saved credentials after the host reloads config if needed.
Avoid `runapi auth import-token --token "$KEY"` directly — the value would be visible in `ps -ef` on shared hosts. Use stdin (`--token -`) or `RUNAPI_API_KEY` in the environment.
## Discover services, commands, and fields
The CLI is JSON-first: every service exposes typed commands, and each command
documents its request fields through `--help`. Always _meta.json
{
"ownerId": "kn70me4rk7jqjt92evshjeb5z18768g7",
"slug": "runapi-cli",
"version": "0.3.1",
"publishedAt": 1790574434718
}skill-card.md
## Description: Guides agents in discovering RunAPI services and pricing, running one-off tasks with the CLI, and making wallet-funded x402 Task calls through the REST API. 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 find RunAPI models and prices, run supported one-off CLI tasks, or pay for and poll eligible REST tasks with an agent wallet. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: A remote installer may execute unreviewed code. Mitigation: Prefer the package-manager install; inspect or verify the remote installer before using the curl-to-shell option. Risk: Task inputs and uploaded files are sent to RunAPI. Mitigation: Use the skill only with data that may be shared with RunAPI. Risk: Wallet-funded tasks may incur charges. Mitigation: Check live pricing and confirm each paid task before spending. Risk: API keys, payment signatures, and listener secrets could be exposed. Mitigation: Keep secrets out of logs and project files; use environment or secure wallet authentication. ## Reference(s): - [RunAPI model and CLI service documentation](https://runapi.ai/models.md) - [RunAPI model catalog](https://runapi.ai/models) ## Skill Output: **Output Type(s):** [Guidance, Shell commands, Configuration instructions] **Output Format:** [Markdown with shell commands and JSON examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [CLI responses are JSON; task results and generated file links come from RunAPI.] ## Skill Version(s): 0.3.1 (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-cli",
"sourceUrl": "https://clawhub.ai/runapi-ai/skills/runapi-cli",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T04:27:27.696Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-cli/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-cli/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T04:27:27.696Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.7K downloads",
"href": "https://clawhub.ai/runapi-ai/runapi-cli",
"sourceUrl": "https://clawhub.ai/runapi-ai/runapi-cli",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T04:27:27.696Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.3.1",
"href": "https://clawhub.ai/runapi-ai/runapi-cli",
"sourceUrl": "https://clawhub.ai/runapi-ai/runapi-cli",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-28T05:47:14.718Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-cli/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-cli/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.3.1",
"description": "## Added - Document x402 payment flows and Task polling for agent workflows using the RunAPI CLI.",
"href": "https://clawhub.ai/runapi-ai/runapi-cli",
"sourceUrl": "https://clawhub.ai/runapi-ai/runapi-cli",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-28T05:47:14.718Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
