proxymock is a transparent proxy-based tool designed to capture, inspect, and replay real API and database traffic to create instant mocks and automated tests without code changes.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install proxymock
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 proxymock 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 proxymock?
proxymock allows developers to capture real-world API and database traffic through a transparent proxy, eliminating the need for manual code changes when creating test environments. By intercepting ingress and egress traffic, it builds a comprehensive map of service interactions that can be used for debugging, local development, or complex integration testing. This tool is a vital part of the Openclaw Skills ecosystem for engineers who need to replicate production scenarios in isolated environments.
The tool facilitates a seamless transition from live traffic to automated mocks. It supports HTTP, gRPC, and even database protocols, allowing you to generate mock servers from OpenAPI specs or existing traffic snapshots. Whether you are running locally or integrating into a cloud-native pipeline, it provides the visibility and control needed to ensure API reliability.
proxymock Use Cases
- Capturing production or staging traffic to debug complex microservice issues locally.
- Generating mock servers from OpenAPI specifications to unblock frontend development teams.
- Running load tests and regression suites in CI/CD pipelines using recorded traffic snapshots.
- Mocking external database dependencies or third-party APIs without modifying application source code.
- Comparing traffic snapshots across different versions of a service to identify breaking changes.
How proxymock Works
- Record: The user launches their application as a child process under the proxy, which captures all inbound and outbound network calls.
- Inspect: Captured traffic is saved as RRPair markdown files, which can be reviewed and edited via a built-in terminal UI (TUI).
- Mock: The tool acts as a server, returning recorded responses for matched requests while passing unmatched traffic to real backends.
- Replay: Recorded sessions are played back against a target URL to validate performance metrics, such as latency and response accuracy.
- Validate: The system provides detailed metrics and can be configured to fail if specific performance or success thresholds are not met.
proxymock Setup
To use this tool within the Openclaw Skills framework, ensure the binary is available in your path. Follow these steps to initialize and start recording:
# Initialize configuration with your API key
proxymock init --api-key <your-key>
# Record traffic while running your application
proxymock record -- npm start
# Start a mock server using previously recorded data
proxymock mock -- go run .
If you are not using the child process mode, you must manually export the proxy environment variables:
export http_proxy=http://localhost:4140
export https_proxy=http://localhost:4140
proxymock Data Schema & Taxonomy
The skill organizes data using the RRPair (Request/Response Pair) format, stored in a human-readable and LLM-friendly markdown structure inside the proxymock/ directory.
| Section | Purpose |
|---|---|
### REQUEST |
Contains the captured method, headers, and body for the test or mock. |
### RESPONSE |
Contains the status code and payload captured during the session. |
### SIGNATURE |
Defines the matching criteria used by the mock server to identify requests. |
You can manually edit these files to modify test data and then run proxymock files update-mocks to synchronize signatures.
proxymock Advanced Features
- MCP Server Integration: Start a Model Context Protocol server to allow AI coding agents to interact directly with your traffic data.
- OpenAPI Generation: Automatically create mocks and test suites from API specification files.
- Load Testing: Simulate multiple virtual users (VUs) and perform stress tests using existing traffic recordings.
- Database Proxying: Intercept and mock database protocols like Postgres using SOCKS5h proxying.
- CI/CD Thresholds: Define specific failure conditions for latency (e.g., p99 > 100ms) or error rates to automate quality gates.
SKILL.md
Loading
Related Openclaw Skills
TikTok Android Bot
A professional-grade ADB automation tool for TikTok that uses AI or templates to drive authentic engagement on Android devices.
Docker Manager
A powerful skill enabling AI agents to manage Docker environments through container lifecycle control and image maintenance.
Docker Pro Diagnostic
An intelligent diagnostic tool that performs advanced log analysis and signal extraction to identify Docker container failures.
Summarize Pro
A high-performance, local AI summarization tool designed to transform long-form content into actionable insights.
Homelab Cluster Management
A comprehensive system for managing distributed AI inference clusters across heterogeneous hardware using Ollama, llama.cpp, and LiteLLM.
Spotify Connect
A sophisticated integration for controlling Spotify playback on remote Connect devices across multiple authenticated accounts.
Featured*
