# Send Postman to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "postman",
    "name": "Postman",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/postman",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/postman",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/postman",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=postman",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "collections.md",
      "memory-template.md",
      "newman.md",
      "setup.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "postman",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T08:40:45.080Z",
      "expiresAt": "2026-05-14T08:40:45.080Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=postman",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=postman",
        "contentDisposition": "attachment; filename=\"postman-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "postman"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/postman"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/postman",
    "downloadUrl": "https://openagent3.xyz/downloads/postman",
    "agentUrl": "https://openagent3.xyz/skills/postman/agent",
    "manifestUrl": "https://openagent3.xyz/skills/postman/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/postman/agent.md"
  }
}
```
## Documentation

### Setup

If ~/postman/ doesn't exist, read setup.md silently and start naturally.

### When to Use

User needs to test APIs, create Postman collections, manage environments, or run automated API tests with Newman.

### Architecture

Data lives in ~/postman/. See memory-template.md for structure.

~/postman/
├── memory.md           # Projects, preferences, common patterns
├── collections/        # Postman collection JSON files
└── environments/       # Environment JSON files

### Quick Reference

TopicFileSetupsetup.mdMemory templatememory-template.mdCollection formatcollections.mdNewman automationnewman.md

### 1. Collection Structure First

Before creating requests, define the collection structure:

Folder hierarchy reflects API organization
Use descriptive names: Users > Create User, not POST 1
Group related endpoints logically

### 2. Environment Variables Always

Never hardcode values that change between environments:

{
  "key": "base_url",
  "value": "https://api.example.com",
  "enabled": true
}

Use {{base_url}} in requests. Environments: dev, staging, prod.

### 3. Pre-request Scripts for Auth

Handle authentication in pre-request scripts, not manually:

// Get token and set for collection
pm.sendRequest({
    url: pm.environment.get("auth_url"),
    method: 'POST',
    body: { mode: 'raw', raw: JSON.stringify({...}) }
}, (err, res) => {
    pm.environment.set("token", res.json().access_token);
});

### 4. Test Assertions Required

Every request needs at least basic assertions:

pm.test("Status 200", () => pm.response.to.have.status(200));
pm.test("Has data", () => pm.expect(pm.response.json()).to.have.property("data"));

### 5. Newman for CI/CD

Run collections headlessly with Newman:

newman run collection.json -e environment.json --reporters cli,json

Exit code 0 = all tests passed. Integrate into CI pipelines.

### Minimal Collection

{
  "info": {
    "name": "My API",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Get Users",
      "request": {
        "method": "GET",
        "url": "{{base_url}}/users",
        "header": [
          { "key": "Authorization", "value": "Bearer {{token}}" }
        ]
      }
    }
  ]
}

### With Tests

{
  "name": "Create User",
  "request": {
    "method": "POST",
    "url": "{{base_url}}/users",
    "body": {
      "mode": "raw",
      "raw": "{\\"name\\": \\"{{$randomFullName}}\\", \\"email\\": \\"{{$randomEmail}}\\"}",
      "options": { "raw": { "language": "json" } }
    }
  },
  "event": [
    {
      "listen": "test",
      "script": {
        "exec": [
          "pm.test('Created', () => pm.response.to.have.status(201));",
          "pm.test('Has ID', () => pm.expect(pm.response.json().id).to.exist);"
        ]
      }
    }
  ]
}

### Environment Format

{
  "name": "Development",
  "values": [
    { "key": "base_url", "value": "http://localhost:3000", "enabled": true },
    { "key": "token", "value": "", "enabled": true }
  ]
}

### Newman Commands

TaskCommandBasic runnewman run collection.jsonWith environmentnewman run collection.json -e dev.jsonSpecific foldernewman run collection.json --folder "Users"Iterationsnewman run collection.json -n 10Data filenewman run collection.json -d data.csvHTML reportnewman run collection.json -r htmlextraBail on failnewman run collection.json --bail

### Common Traps

Hardcoded URLs → Tests break between environments. Always use {{base_url}}.
No assertions → Tests "pass" but don't validate anything. Add status + body checks.
Secrets in collection → Credentials leak. Use environment variables, gitignore env files.
Sequential dependencies → Tests fail randomly. Use setNextRequest() explicitly or make tests independent.
Missing Content-Type → POST/PUT fails silently. Always set Content-Type: application/json.

### Dynamic Variables

Postman built-in variables for test data:

VariableExample Output{{$randomFullName}}"Jane Doe"{{$randomEmail}}"jane@example.com"{{$randomUUID}}"550e8400-e29b-..."{{$timestamp}}1234567890{{$randomInt}}42

### OpenAPI to Postman

Import OpenAPI/Swagger specs:

Export OpenAPI JSON/YAML
In Postman: Import > File > Select spec
Collection auto-generated with all endpoints

Or via CLI:

npx openapi-to-postmanv2 -s openapi.yaml -o collection.json

### Security & Privacy

Data that stays local:

Collections and environments in ~/postman/
Newman runs locally

This skill does NOT:

Send collections to external services
Store API credentials in memory.md

### Related Skills

Install with clawhub install <slug> if user confirms:

api — REST API consumption patterns
json — JSON manipulation and validation
ci-cd — Pipeline automation

### Feedback

If useful: clawhub star postman
Stay updated: clawhub sync
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-07T08:40:45.080Z
- Expires at: 2026-05-14T08:40:45.080Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/postman)
- [Send to Agent page](https://openagent3.xyz/skills/postman/agent)
- [JSON manifest](https://openagent3.xyz/skills/postman/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/postman/agent.md)
- [Download page](https://openagent3.xyz/downloads/postman)