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
CODEBLOCK0
Output Structure
CODEBLOCK1
Supported Auth Types
| Type | Support | Config |
|---|
| API Key (header) | ✅ | INLINECODE0 |
| 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.
CODEBLOCK2
validate
Validate OpenAPI spec before generating.
CODEBLOCK3
test
Test generated skill against live API.
CODEBLOCK4
Generated Skill Example
CODEBLOCK5 bash
stripe-api customers list --limit 10
stripe-api customers create --email "user@example.com"
stripe-api charges create --amount 1000 --currency usd
CODEBLOCK6
Benefits
- 1. 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 guide - INLINECODE6 — Skill templates
- INLINECODE7 — Main generator
技能名称: neckr0ik-api-wrapper
详细描述:
API 包装器生成器
从REST API自动生成OpenClaw技能。
功能说明
- - 解析OpenAPI规范 — 读取API文档
- 生成技能文件 — SKILL.md、脚本、claw.json
- 处理认证 — API密钥、OAuth、Bearer令牌
- 创建类型安全的包装器 — 验证请求/响应
- 记录端点 — 每个操作的使用示例
快速开始
bash
从OpenAPI规范生成技能
neckr0ik-api-wrapper generate --spec https://api.example.com/openapi.json --name my-api
从URL生成（自动发现OpenAPI）
neckr0ik-api-wrapper generate --url https://api.example.com --name my-api
从本地文件生成
neckr0ik-api-wrapper generate --spec ./openapi.yaml --name my-api
输出结构
my-api/
├── SKILL.md # 技能文档
├── claw.json # 包元数据
└── scripts/
└── api.py # 生成的API客户端
支持的认证类型
| 类型 | 支持 | 配置 |
|---|
| API密钥（请求头） | ✅ | --auth header:X-API-Key |
| API密钥（查询参数） |
✅ | --auth query:api_key |
| Bearer令牌 | ✅ | --auth bearer |
| 基本认证 | ✅ | --auth basic |
| OAuth 2.0 | ✅ | --auth oauth2 |
命令
generate
从API规范生成OpenClaw技能。
bash
neckr0ik-api-wrapper generate [options]
选项：
--spec OpenAPI规范URL或文件
--url API基础URL（自动发现规范）
--name 技能名称（默认：API名称）
--output 输出目录
--auth 认证类型
--include 包含特定端点（逗号分隔）
--exclude 排除特定端点（逗号分隔）
validate
在生成前验证OpenAPI规范。
bash
neckr0ik-api-wrapper validate --spec
test
针对实时API测试生成的技能。
bash
neckr0ik-api-wrapper test --skill ./my-api --endpoint
生成技能示例
markdown
从Stripe API生成
快速开始
bash
stripe-api customers list --limit 10
stripe-api customers create --email user@example.com
stripe-api charges create --amount 1000 --currency usd
端点
customers.list
列出所有客户。
- - 方法：GET
- 路径：/v1/customers
- 认证：Bearer令牌
customers.create
创建新客户。
- - 方法：POST
- 路径：/v1/customers
- 认证：Bearer令牌
- 请求体：email、name、metadata
优势
- 1. 速度 — 几分钟内生成技能，而非数小时
- 一致性 — 所有API技能采用标准格式
- 文档 — 从OpenAPI自动生成
- 类型安全 — 请求/响应验证
- 可维护性 — API更新时可重新生成
使用场景
- - API提供商 — 为您的API创建技能
- 开发者 — 快速集成新API
- 变现 — 为热门API销售技能
可包装的API示例
- - Stripe支付API
- OpenAI API
- Slack API
- Notion API
- GitHub API
- 任何符合OpenAPI规范的API
参见
- - references/openapi.md — OpenAPI规范指南
- references/templates/ — 技能模板
- scripts/generator.py — 主生成器
