Zyla Api Hub Skill
Zyla API Hub Skill — Turn your OpenClaw AI agent into a real-world operator.
- Rating
- 4.3 (471 reviews)
- Downloads
- 6,072 downloads
- Version
- 1.0.0
Overview
Zyla API Hub Skill — Turn your OpenClaw AI agent into a real-world operator.
Complete Documentation
View Source →
Zyla API Hub Skill
Turn your OpenClaw AI agent into a real-world operator. Power it with 10,000+ production-ready APIs from Zyla API Hub — instant access to weather, finance, translation, email validation, geolocation, and more, all through one unified API key, pay-as-you-go pricing, and zero vendor lock-in.
Setup
If ZYLA_API_KEY is not configured, guide the user:
- Visit https://zylalabs.com/openclaw/connect to get an API key
- Or run
/zyla connectif the plugin is installed (opens browser automatically) - Add the key to
~/.openclaw/openclaw.jsonunderskills.entries.zyla-api-hub-skill.apiKey
Quick Start — Popular APIs
Use these directly without searching the catalog. Each includes the API ID, endpoint details, and parameters.
Weather by Zip API (ID: 781)
- Use when: user asks about weather, temperature, forecast, climate, conditions by zip code
- Category: Weather & Environment
- Call:
npx tsx {baseDir}/scripts/zyla-api.ts call --api 781 --endpoint--params '{"zip":"10001"}'
Currency Conversion API (example)
- Use when: user asks about currency exchange, conversion rates, forex
- Category: Finance
- Call:
npx tsx {baseDir}/scripts/zyla-api.ts call --api--endpoint --params '{"from":"USD","to":"EUR","amount":"100"}'
Email Validation API (example)
- Use when: user asks to validate, verify, or check an email address
- Category: Data Validation
- Call:
npx tsx {baseDir}/scripts/zyla-api.ts call --api--endpoint --params '{"email":"[email protected]"}'
Note: Run npx tsx {baseDir}/scripts/generate-popular.ts to regenerate this section with real API IDs and endpoints from the live catalog.Discovering APIs
For APIs not listed above, search the catalog:
# Search by keyword
npx tsx {baseDir}/scripts/zyla-catalog.ts search "recipe"
# List APIs by category
npx tsx {baseDir}/scripts/zyla-catalog.ts list --category "Finance"
# Get endpoints for a specific API
npx tsx {baseDir}/scripts/zyla-catalog.ts endpoints --api 781
Calling APIs
Using the helper script (recommended)
# Basic call
npx tsx {baseDir}/scripts/zyla-api.ts call \
--api <api_id> \
--endpoint <endpoint_id> \
--params '{"key":"value"}'
# Specify HTTP method (default: GET)
npx tsx {baseDir}/scripts/zyla-api.ts call \
--api <api_id> \
--endpoint <endpoint_id> \
--method POST \
--params '{"key":"value"}'
# Get info about an API
npx tsx {baseDir}/scripts/zyla-api.ts info --api <api_id>
# Check health and remaining quota
npx tsx {baseDir}/scripts/zyla-api.ts health
Using curl (fallback)
curl -H "Authorization: Bearer $ZYLA_API_KEY" \
"https://zylalabs.com/api/{api_id}/{api_slug}/{endpoint_id}/{endpoint_slug}?param=value"
URL pattern: https://zylalabs.com/api/{api_id}/{api_name_slug}/{endpoint_id}/{endpoint_name_slug}
api_idandendpoint_idare numeric IDs (these do the actual routing)api_name_slugandendpoint_name_slugare URL-friendly names (for readability)
Error Handling
- 401 Unauthorized: API key is invalid or expired. Ask the user to run
/zyla connector visit https://zylalabs.com/openclaw/connect to get a new key. - 403 Forbidden: Subscription issue. The pay-as-you-go plan should handle this automatically. If it persists, ask the user to contact support.
- 429 Too Many Requests: Rate limit exceeded. Check the
X-Zyla-RateLimit-Minute-Remainingresponse header. Wait before retrying. - 404 Not Found: The API or endpoint does not exist. Verify the IDs using the catalog.
- 5xx Server Error: Upstream API issue. Retry after a short delay (2-5 seconds).
Rate Limit Headers
Every API response includes these headers:
X-Zyla-RateLimit-Minute-Limit: Max requests per minuteX-Zyla-RateLimit-Minute-Remaining: Remaining requests this minuteX-Zyla-API-Calls-Monthly-Used: Total calls this billing cycleX-Zyla-API-Calls-Monthly-Remaining: Remaining calls this cycle
Billing
- Pay-as-you-go: No monthly fee. Each API call is billed at the API's per-call rate.
- Billing happens at the end of each cycle via Stripe.
- Use the health endpoint to check current usage:
npx tsx {baseDir}/scripts/zyla-api.ts health
Installation
openclaw install zyla-api-hub-skill
💻Code Examples
npx tsx {baseDir}/scripts/zyla-catalog.ts endpoints --api 781
## Calling APIs
### Using the helper script (recommended)# Search by keyword
npx tsx {baseDir}/scripts/zyla-catalog.ts search "recipe"
# List APIs by category
npx tsx {baseDir}/scripts/zyla-catalog.ts list --category "Finance"
# Get endpoints for a specific API
npx tsx {baseDir}/scripts/zyla-catalog.ts endpoints --api 781# Basic call
npx tsx {baseDir}/scripts/zyla-api.ts call \
--api <api_id> \
--endpoint <endpoint_id> \
--params '{"key":"value"}'
# Specify HTTP method (default: GET)
npx tsx {baseDir}/scripts/zyla-api.ts call \
--api <api_id> \
--endpoint <endpoint_id> \
--method POST \
--params '{"key":"value"}'
# Get info about an API
npx tsx {baseDir}/scripts/zyla-api.ts info --api <api_id>
# Check health and remaining quota
npx tsx {baseDir}/scripts/zyla-api.ts healthTags
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw — a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Acestep Lyrics Transcription
Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.