A lightweight Python-based toolkit for testing, validating, and benchmarking REST API endpoints without external dependencies.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install rest-api-test-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install rest-api-test-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is API Tester?
The API Tester is a robust utility designed for developers and QA engineers who need a fast, dependency-free way to interact with RESTful services. Built using only the Python standard library, it ensures maximum portability across Linux, macOS, and Windows environments while providing high-level features typically found in bloated testing suites.
As a featured component of Openclaw Skills, this tool excels at individual endpoint debugging, performance benchmarking, and automated validation of response structures. It bridges the gap between simple curl commands and complex automated testing frameworks, offering a streamlined workflow for verifying API integrity and performance metrics.
API Tester Use Cases
- Rapidly debugging HTTP responses including status codes, headers, and bodies.
- Validating API responses against expected JSON keys and status codes during CI/CD pipelines.
- Benchmarking endpoint performance to identify latency issues or regressions.
- Automated testing of entire API surfaces using existing OpenAPI/Swagger specifications.
- Generating shareable, styled HTML test reports for stakeholders and team members.
How API Tester Works
- The user provides a target URL and optional parameters such as HTTP method, headers, or request body via the CLI.
- The skill executes the request using Python's native urllib, capturing precise timing and response data.
- If validation flags are present, the tool compares the actual status code, response time, and JSON structure against user-defined expectations.
- For benchmarking tasks, the skill repeats the request for a specified number of iterations and calculates statistical aggregates like Min, Max, and Median latency.
- The results are output to the terminal or compiled into a structured HTML report for persistent documentation.
API Tester Setup
The API Tester requires Python 3.6 or higher. Since it uses only the standard library, no pip installations are necessary. To get started, clone your Openclaw Skills repository and run the script directly:
# Navigate to the skill directory
cd skills/api-tester/scripts/
# Run a basic GET request
python3 api_tester.py --url https://api.github.com/repos/openclaw/openclaw
API Tester Data Schema & Taxonomy
The skill processes inputs through command-line arguments and can ingest data from external files. It organizes outputs as follows:
| Data Type | Format | Description |
|---|---|---|
| Request Body | JSON / File | Supports inline JSON strings or paths to .json files via --body-file. |
| Validation Rules | CLI Flags | Parameters like --validate-keys define the expected schema for incoming data. |
| Reports | HTML | Standalone, CSS-styled files generated with timestamps (e.g., api-test-report-YYYYMMDD.html). |
| API Specs | OpenAPI/JSON | Ingests standard OpenAPI 3.0/Swagger files to map all available endpoints automatically. |
API Tester Advanced Features
- Multi-iteration benchmarking with statistical analysis (Average, Median, Success Rate).
- Automated discovery and testing of all routes defined in an OpenAPI specification file.
- Granular response validation including key existence checks and maximum response time thresholds.
- Detailed verbose logging for inspecting raw headers and request/response payloads during deep debugging sessions.
SKILL.md
Loading
Related Openclaw Skills
System Doctor (sys-doctor)
A comprehensive system diagnostics and health check tool for Linux servers that generates detailed reports in terminal, HTML, or JSON formats.
BrickLink AFOL Skill
A professional-grade CLI integration for the BrickLink API that enables automated Lego inventory management, order processing, and market data retrieval.
BrickEconomy AFOL Skill
A professional-grade LEGO valuation and investment tracking tool that integrates BrickEconomy API data directly into your AI agent workflow.
BrickEconomy LEGO Asset Analysis
A comprehensive LEGO valuation and portfolio analysis skill that leverages the BrickEconomy API to track set performance and investment ROI.
Backup Rotator
A robust Python-based tool for managing automated backup rotation, retention policies, and file integrity verification.
Claude Managed Agents
An end-to-end orchestration skill for managing Anthropic Claude Managed Agents through a robust Python helper or the native ant CLI.
Featured*
