- name
- neckr0ik-api-wrapper
- version
- 1.0.0
- description
- Convert any REST API into an OpenClaw skill automatically. Generates SKILL.md, scripts, and claw.json from OpenAPI spec or URL. Use when you want to quickly create a skill for any API.
API Wrapper Generator
Automatically generate OpenClaw skills from REST APIs.
What This Does
- Parses OpenAPI specs — Read API documentation
- Generates skill files — SKILL.md, scripts, claw.json
- Handles authentication — API keys, OAuth, Bearer tokens
- Creates type-safe wrappers — Validates requests/responses
- Documents endpoints — Usage examples for each operation
Quick Start
# Generate skill from OpenAPI spec
neckr0ik-api-wrapper generate --spec https://api.example.com/openapi.json --name my-api
# Generate from URL (discovers OpenAPI)
neckr0ik-api-wrapper generate --url https://api.example.com --name my-api
# Generate from local file
neckr0ik-api-wrapper generate --spec ./openapi.yaml --name my-apiOutput Structure
my-api/
├── SKILL.md # Skill documentation
├── claw.json # Package metadata
└── scripts/
└── api.py # Generated API clientSupported Auth Types
| Type | Support | Config |
|---|---|---|
| API Key (header) | ✅ | --auth header:X-API-Key |
| API Key (query) | ✅ | --auth query:api_key |
| Bearer Token | ✅ | --auth bearer |
| Basic Auth | ✅ | --auth basic |
| OAuth 2.0 | ✅ | --auth oauth2 |
Commands
generate
Generate OpenClaw skill from API spec.
neckr0ik-api-wrapper generate [options]
Options:
--spec <url> OpenAPI spec URL or file
--url <url> API base URL (discovers spec)
--name <name> Skill name (default: api name)
--output <dir> Output directory
--auth <type> Authentication type
--include <endpoints> Include specific endpoints (comma-sep)
--exclude <endpoints> Exclude specific endpoints (comma-sep)validate
Validate OpenAPI spec before generating.
neckr0ik-api-wrapper validate --spec <url>test
Test generated skill against live API.
neckr0ik-api-wrapper test --skill ./my-api --endpoint <operationId>Generated Skill Example
# Generated from Stripe API
## Quick Start
stripe-api customers list --limit 10 stripe-api customers create --email "user@example.com" stripe-api charges create --amount 1000 --currency usd
## Endpoints
### customers.list
List all customers.
- Method: GET
- Path: /v1/customers
- Auth: Bearer Token
### customers.create
Create a new customer.
- Method: POST
- Path: /v1/customers
- Auth: Bearer Token
- Body: email, name, metadataBenefits
- Speed — Generate skills in minutes, not hours
- Consistency — Standard format for all API skills
- Documentation — Auto-generated from OpenAPI
- Type Safety — Request/response validation
- Maintainability — Regenerate when API updates
Use Cases
- API Providers — Create skills for your APIs
- Developers — Quickly integrate new APIs
- Monetization — Sell skills for popular APIs
Example APIs to Wrap
- Stripe Payments API
- OpenAI API
- Slack API
- Notion API
- GitHub API
- Any OpenAPI-compliant API
See Also
references/openapi.md— OpenAPI specification guidereferences/templates/— Skill templatesscripts/generator.py— Main generator