Neckr0ik Api Wrapper

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...

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-api

Output Structure

my-api/
├── SKILL.md           # Skill documentation
├── claw.json          # Package metadata
└── scripts/
    └── api.py         # Generated API client

Supported 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

```bash
stripe-api customers list --limit 10
stripe-api customers create --email "[e-mail]"
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, metadata

## Benefits

1. **Speed** — Generate skills in minutes, not hours
2. **Consistency** — Standard format for all API skills
3. **Documentation** — Auto-generated from OpenAPI
4. **Type Safety** — Request/response validation
5. **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 guide
- `references/templates/` — Skill templates
- `scripts/generator.py` — Main generator