An automated command-line tool for running Postman collections to enable seamless API testing and reporting.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install newman
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 newman 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 Newman - Postman CLI Runner?
Newman is the official command-line collection runner for Postman, designed to allow developers to run and test API collections directly from their terminal or within automated environments. By utilizing Openclaw Skills like Newman, teams can transition from manual API validation to a robust, automated testing framework that ensures consistency across dev, staging, and production environments.
Built on Node.js, it offers full parity with the Postman desktop app's execution engine, meaning your pre-request scripts and test assertions will run exactly as expected. This skill is a cornerstone for modern development workflows that prioritize API-first design and continuous integration.
Newman - Postman CLI Runner Use Cases
- Running automated regression tests for API endpoints during development.
- Integrating API test suites into CI/CD pipelines such as GitHub Actions, GitLab CI, or Jenkins.
- Executing data-driven tests using external CSV or JSON files to validate multiple scenarios.
- Generating shareable HTML or JUnit reports for quality assurance and stakeholder review.
- Performing basic load testing by running collections with high iteration counts and specific delays.
How Newman - Postman CLI Runner Works
- Export your API requests and test scripts from the Postman desktop application as a v2.1 Collection JSON file.
- Optional: Export environment variables as an Environment JSON file to manage stage-specific data.
- Use the Newman CLI to execute the collection, passing in the JSON files and any required data sources.
- Newman processes each request in the collection, executing pre-request scripts and validating test assertions.
- The tool generates real-time feedback in the terminal and saves detailed reports in your preferred format (HTML, JSON, or XML).
Newman - Postman CLI Runner Setup
To get started with this skill, ensure you have Node.js installed on your system. You can then install the runner globally or within your specific project.
# Install Newman globally via npm
npm install -g newman
# Verify the installation
newman --version
# Run a collection file locally
newman run your-collection.json
Newman - Postman CLI Runner Data Schema & Taxonomy
Newman manages data through several specialized file formats to ensure portability and security within Openclaw Skills workflows:
| Data Type | Format | Purpose |
|---|---|---|
| Collection | .json | Defines requests, folders, and JavaScript test scripts. |
| Environment | .json | Stores variables like base URLs and non-sensitive keys. |
| Globals | .json | Variables accessible across all collections and environments. |
| Iteration Data | .csv / .json | External data used to populate variables during bulk test runs. |
| Reports | .html / .xml | Structured output files for test result analysis and CI integration. |
Newman - Postman CLI Runner Advanced Features
- Support for JavaScript-based pre-request and test scripts for dynamic request handling.
- Integration with system environment variables to securely inject API keys and secrets at runtime.
- Advanced SSL/TLS configuration including support for client certificates and insecure mode for dev environments.
- Multi-reporter capabilities allowing simultaneous output to CLI, HTML, and JUnit formats.
- Parallel execution support when combined with additional Node.js wrappers for high-scale testing.
- Ability to bail on first failure to optimize CI/CD pipeline execution time.
SKILL.md
Loading
Related Openclaw Skills
Mermaid Architect
A specialized agent skill for generating robust, visually appealing Mermaid.js diagrams using safe syntax and professional layouts.
Memory Cache
A standardized Redis-backed caching system for managing AI agent state, session context, and high-speed data retrieval.
Mema Brain
A standardized memory system that combines a SQLite metadata index for document organization with a Redis-powered short-term context buffer.
Human Writing
A specialized skill designed to eliminate AI stylistic tells and produce high-density, professional technical documentation.
Node-RED Manager
A powerful management tool for Node-RED instances that enables automated flow deployment, node management, and runtime diagnostics via a streamlined CLI.
Pi-hole Controller (pihole-ctl)
A powerful management and monitoring skill for local Pi-hole instances that provides deep insights and control via CLI and FTL database queries.
Featured*
