An advanced API development and testing skill that lets AI agents seamlessly manage Postman collections, workspaces, specifications, and mock servers without manual token handling.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install oo-postman
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 oo-postman 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 Postman (oo-postman)?
The Postman skill is a powerful automation integration designed for developers and AI agents operating within Openclaw Skills environments. It enables full-lifecycle management of Postman resources, allowing agents to execute complex API operations such as reading, creating, updating, and deleting collections, environments, specifications, and monitors. By utilizing the OOMOL-connected account via the oo CLI, credential injection is handled securely on the server side, ensuring that raw API tokens are never exposed within local environments.
Whether you are constructing automated testing pipelines, syncing OpenAPI specifications, or keeping environment variables updated dynamically, this skill transforms your AI coder into a fully capable API development assistant. It bridges the gap between local AI reasoning and the robust web-based Postman platform, enhancing overall developer productivity and automating repetitive API design tasks.
Postman (oo-postman) Use Cases
- Automating API documentation by generating collections directly from updated OpenAPI specifications.
- Establishing regression and contract tests by linking Postman collections and mock servers to API schemas.
- Synchronizing environment variables and global configurations across testing, staging, and production workspaces.
- Managing API workspaces, folders, and request collections dynamically during rapid prototyping phases.
- Triggering instant runs of scheduled Postman monitors to verify endpoint availability during DevOps deployments.
How Postman (oo-postman) Works
- Inspect Schema: The AI agent queries the authoritative contract schema for a specific Postman action to ensure exact payload compliance.
- Payload Construction: The agent designs a compliant JSON data payload tailored to the targeted Postman workspace or collection.
- CLI Execution: The agent triggers the action through the secure oo CLI framework.
- Secure Authentication: Credentials are dynamically injected server-side by OOMOL, avoiding exposure of local API keys.
- Execution Response: The skill returns a JSON response containing the direct execution output alongside metadata like the unique execution ID.
Postman (oo-postman) Setup
1. Install the oo CLI
For macOS / Linux:
curl -fsSL https://cli.oomol.com/install.sh | bash
For Windows PowerShell:
irm https://cli.oomol.com/install.ps1 | iex
2. Sign In to OOMOL
Execute the authentication login once to connect your shell session:
oo auth login
3. Connect Postman
Configure your Postman connection with an API key securely at the OOMOL Console app connections page:
https://console.oomol.com/app-connections?provider=postman
4. Recharge Credits (If Needed)
If you encounter billing limits or HTTP 402 error status, recharge your tokens at:
https://console.oomol.com/billing/token-recharge
Postman (oo-postman) Data Schema & Taxonomy
The Postman skill organizes its operations through structured JSON payloads matched to Postman's native schema. All interaction schemas can be fetched dynamically to prevent version mismatch.
| CLI Command / Parameter | Data Type | Description |
|---|---|---|
--action |
String | The specific Postman operation to perform (e.g., create_a_collection). |
--data |
JSON String / File | The JSON payload matched to the Postman API schema or path (@path/to/file.json). |
--json |
Flag | Specifies that the CLI output should be returned in structured JSON format. |
Schema Inspection
Before sending state-changing requests, retrieve the live schema of the desired action:
oo connector schema "postman" --action "<action_name>"
Output Format
The CLI standardized JSON output structure is formatted as:
{
"data": { ... },
"meta": {
"executionId": "unique-task-execution-uuid"
}
}
Postman (oo-postman) Advanced Features
- Asynchronous Collection and Spec Syncing: Efficiently synchronize collections with changing OpenAPI schemas and single-file API specifications without blocking the agent workflow.
- Mock Server and Webhook Orchestration: Programmatically create and configure mock servers, simulate server-level errors (5xx responses), and configure webhooks to trigger remote collections.
- Dynamic Forking and Merging: Manage complex multi-workspace environments by programmatically creating forks, tracking parent changes, and merging updates back.
- Activity and Access Control Management: Programmatically inspect workspace activity feeds and pull request lifecycles directly within Openclaw Skills pipelines.
- State Change Safeguards: Employs built-in safety tagging (
[write]and[destructive]) ensuring the AI agent requests explicit confirmation before carrying out non-idempotent or destructive operations.
SKILL.md
Loading
Related Openclaw Skills
Linux DO Integration
A CLI-powered AI agent skill designed to query, search, and monitor forum topics, posts, and user activity from Linux DO without raw credential handling.
ParseHub Integration
An automated integration enabling AI agents and developers to safely run ParseHub web scraping projects and retrieve structured web data without writing custom scrapers.
MailerLite Integration
Securely read, create, update, and delete MailerLite subscribers and groups via an AI-ready CLI connector.
oo-pingdom
A specialized tool that enables AI agents to query and monitor Pingdom uptime checks, credits, and probe locations securely via the oo CLI.
OpenCage
An OpenCage geocoding skill that enables AI agents to perform forward, reverse, and GeoJSON-formatted coordinate lookup through the OOMOL-connected oo CLI.
NASA
A powerful NASA science and astronomy data exploration skill for AI coding agents to search near-Earth objects, fetch space weather alerts, and retrieve deep space imagery without handling raw API credentials.
Featured*
