# Send Newman 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "newman",
    "name": "Newman",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/1999AZZAR/newman",
    "canonicalUrl": "https://clawhub.ai/1999AZZAR/newman",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/newman",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=newman",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "INSTALLATION.md",
      "README.md",
      "SKILL.md",
      "references/advanced-patterns.md",
      "references/ci-cd-examples.md",
      "scripts/install-newman.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "newman",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-06T03:03:42.943Z",
      "expiresAt": "2026-05-13T03:03:42.943Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=newman",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=newman",
        "contentDisposition": "attachment; filename=\"newman-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "newman"
      },
      "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/newman"
    },
    "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/newman",
    "downloadUrl": "https://openagent3.xyz/downloads/newman",
    "agentUrl": "https://openagent3.xyz/skills/newman/agent",
    "manifestUrl": "https://openagent3.xyz/skills/newman/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/newman/agent.md"
  }
}
```
## Documentation

### Newman - Postman CLI Runner

Newman is the command-line Collection Runner for Postman. Run and test Postman collections directly from the command line with powerful reporting, environment management, and CI/CD integration.

### Installation

# Global install (recommended)
npm install -g newman

# Project-specific
npm install --save-dev newman

# Verify
newman --version

### Basic Execution

# Run collection
newman run collection.json

# With environment
newman run collection.json -e environment.json

# With globals
newman run collection.json -g globals.json

# Combined
newman run collection.json -e env.json -g globals.json -d data.csv

### 1. Export from Postman Desktop

In Postman:

Collections → Click "..." → Export
Choose "Collection v2.1" (recommended)
Save as collection.json

Environment:

Environments → Click "..." → Export
Save as environment.json

### 2. Run Tests

# Basic run
newman run collection.json

# With detailed output
newman run collection.json --verbose

# Fail on errors
newman run collection.json --bail

# Custom timeout (30s)
newman run collection.json --timeout-request 30000

### 3. Data-Driven Testing

CSV format:

username,password
user1,pass1
user2,pass2

Run:

newman run collection.json -d test_data.csv --iteration-count 2

### 4. Reporters

# CLI only (default)
newman run collection.json

# HTML report
newman run collection.json --reporters cli,html --reporter-html-export report.html

# JSON export
newman run collection.json --reporters cli,json --reporter-json-export results.json

# JUnit (for CI)
newman run collection.json --reporters cli,junit --reporter-junit-export junit.xml

# Multiple reporters
newman run collection.json --reporters cli,html,json,junit \\
  --reporter-html-export ./reports/newman.html \\
  --reporter-json-export ./reports/newman.json \\
  --reporter-junit-export ./reports/newman.xml

### 5. Security Best Practices

❌ NEVER hardcode secrets in collections!

Use environment variables:

# Export sensitive vars
export API_KEY="your-secret-key"
export DB_PASSWORD="your-db-pass"

# Newman auto-loads from env
newman run collection.json -e environment.json

# Or pass directly
newman run collection.json --env-var "API_KEY=secret" --env-var "DB_PASSWORD=pass"

In Postman collection tests:

// Use {{API_KEY}} in requests
pm.request.headers.add({key: 'Authorization', value: \`Bearer {{API_KEY}}\`});

// Access in scripts
const apiKey = pm.environment.get("API_KEY");

Environment file (environment.json):

{
  "name": "Production",
  "values": [
    {"key": "BASE_URL", "value": "https://api.example.com", "enabled": true},
    {"key": "API_KEY", "value": "{{$processEnvironment.API_KEY}}", "enabled": true}
  ]
}

Newman will replace {{$processEnvironment.API_KEY}} with the environment variable.

### CI/CD Integration

See references/ci-cd-examples.md for GitHub Actions, GitLab CI, and Jenkins examples.

### Automated Regression Testing

#!/bin/bash
# scripts/run-api-tests.sh

set -e

echo "Running API tests..."

newman run collections/api-tests.json \\
  -e environments/staging.json \\
  --reporters cli,html,junit \\
  --reporter-html-export ./test-results/newman.html \\
  --reporter-junit-export ./test-results/newman.xml \\
  --bail \\
  --color on

echo "Tests completed. Report: ./test-results/newman.html"

### Load Testing

# Run with high iteration count
newman run collection.json \\
  -n 100 \\
  --delay-request 100 \\
  --timeout-request 5000 \\
  --reporters cli,json \\
  --reporter-json-export load-test-results.json

### Parallel Execution

# Install parallel runner
npm install -g newman-parallel

# Run collections in parallel
newman-parallel -c collection1.json,collection2.json,collection3.json \\
  -e environment.json \\
  --reporters cli,html

### Custom Scripts

Pre-request Script (in Postman):

// Generate dynamic values
pm.environment.set("timestamp", Date.now());
pm.environment.set("nonce", Math.random().toString(36).substring(7));

Test Script (in Postman):

// Status code check
pm.test("Status is 200", function() {
    pm.response.to.have.status(200);
});

// Response body validation
pm.test("Response has user ID", function() {
    const jsonData = pm.response.json();
    pm.expect(jsonData).to.have.property('user_id');
});

// Response time check
pm.test("Response time < 500ms", function() {
    pm.expect(pm.response.responseTime).to.be.below(500);
});

// Set variable from response
pm.environment.set("user_token", pm.response.json().token);

### SSL/TLS Configuration

# Disable SSL verification (dev only!)
newman run collection.json --insecure

# Custom CA certificate
newman run collection.json --ssl-client-cert-list cert-list.json

# Client certificates
newman run collection.json \\
  --ssl-client-cert client.pem \\
  --ssl-client-key key.pem \\
  --ssl-client-passphrase "secret"

### Error Handling

# Continue on errors
newman run collection.json --suppress-exit-code

# Fail fast
newman run collection.json --bail

# Custom error handling in wrapper
#!/bin/bash
newman run collection.json -e env.json
EXIT_CODE=$?

if [ $EXIT_CODE -ne 0 ]; then
    echo "Tests failed! Exit code: $EXIT_CODE"
    # Send alert, rollback deployment, etc.
    exit 1
fi

### Troubleshooting

Collection not found:

Use absolute paths: newman run /full/path/to/collection.json
Check file permissions: ls -la collection.json

Environment variables not loading:

Verify syntax: {{$processEnvironment.VAR_NAME}}
Check export: echo $VAR_NAME
Use --env-var flag as fallback

Timeout errors:

Increase timeout: --timeout-request 60000 (60s)
Check network connectivity
Verify API endpoint is reachable

SSL errors:

Development: Use --insecure temporarily
Production: Add CA cert with --ssl-extra-ca-certs

Memory issues (large collections):

Reduce iteration count
Split collection into smaller parts
Increase Node heap: NODE_OPTIONS=--max-old-space-size=4096 newman run ...

### Best Practices

Version Control: Store collections and environments in Git
Environment Separation: Separate files for dev/staging/prod
Secret Management: Use environment variables, never commit secrets
Meaningful Names: Use descriptive collection and folder names
Test Atomicity: Each request should test one specific thing
Assertions: Add comprehensive test scripts to every request
Documentation: Use Postman descriptions for context
CI Integration: Run Newman in CI pipeline for every PR
Reports: Archive HTML reports for historical analysis
Timeouts: Set reasonable timeout values for production APIs

### References

CI/CD Examples: See references/ci-cd-examples.md
Advanced Patterns: See references/advanced-patterns.md
Official Docs: https://learning.postman.com/docs/running-collections/using-newman-cli/command-line-integration-with-newman/
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: 1999AZZAR
- 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-06T03:03:42.943Z
- Expires at: 2026-05-13T03:03:42.943Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/newman)
- [Send to Agent page](https://openagent3.xyz/skills/newman/agent)
- [JSON manifest](https://openagent3.xyz/skills/newman/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/newman/agent.md)
- [Download page](https://openagent3.xyz/downloads/newman)