A powerful gateway skill for bridging local API services to remote agents over the Pilot Protocol network.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pilot-api-gateway
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 pilot-api-gateway 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 Pilot API Gateway?
The Pilot API Gateway is a specialized tool designed to securely bridge local API services with the Pilot Protocol network. This skill allows developers to expose RESTful services or custom API endpoints to remote agents and services without the need for traditional public internet exposure or complex firewall configurations.
By leveraging this Openclaw Skills integration, users can build robust API-based agent services that maintain high security and privacy. Whether you are mapping existing HTTP/HTTPS hostnames to local IPs or listening for custom messaging-based requests, this gateway provides the necessary infrastructure for seamless cross-network communication.
Pilot API Gateway Use Cases
- Exposing local development APIs to remote Pilot agents for testing and integration.
- Providing secure API access to agent services without opening public ports.
- Building custom API-based services on the Pilot Protocol using messaging-based responses.
- Mapping specific local network resources to identifiable hostnames within the Pilot network.
How Pilot API Gateway Works
- The skill requires an active pilotctl daemon running on the local system.
- Users initiate the gateway mode or set up a listener on a specific port to intercept incoming network requests.
- Incoming requests from remote agents are parsed to identify the intended method, path, and sender metadata.
- The gateway either automatically maps the traffic to a local IP or allows a custom script to process the request logic.
- A response is generated and sent back to the requesting client using the pilotctl messaging system, completing the API lifecycle.
Pilot API Gateway Setup
To get started with the Pilot API Gateway, ensure you have the pilotctl binary on your PATH and the pilot-protocol skill installed. Start the daemon before initializing the gateway:
# Start the Pilot daemon
pilotctl daemon start
# Initialize the API gateway in JSON mode
pilotctl --json gateway start
# Map a local API to a Pilot hostname
pilotctl --json gateway map <hostname> <local-ip>
Pilot API Gateway Data Schema & Taxonomy
The skill utilizes JSON-formatted messaging to manage requests and responses. Below is the primary structure used for custom API handling:
| Field | Description | Type |
|---|---|---|
method |
The HTTP method (GET, POST, etc.) | String |
path |
The API endpoint path requested | String |
sender |
The unique identifier of the remote client | String |
data |
The payload or response body | String/JSON |
timeout |
The duration to wait for incoming requests | String |
Pilot API Gateway Advanced Features
- Custom messaging-based API servers using the
listenandrecvcommands for high flexibility. - Public hostname broadcasting with the
--publicflag during daemon initialization. - Automated response routing using sender metadata to facilitate multi-agent communication.
- Integration with jq for sophisticated request parsing and logic branching in shell scripts.
SKILL.md
Loading
Related Openclaw Skills
Pipeworx Holidays
A comprehensive toolset for accessing global public holiday data from over 100 countries using the Nager.Date API.
Pipeworx Hacker News
A comprehensive integration for searching and browsing Hacker News content through Algolia and Firebase APIs.
Copilot Usage Skill
A specialized monitoring tool to track GitHub Copilot premium request usage, monthly quotas, and per-model billing statistics via the GitHub CLI.
Pipeworx HTTP Cats
A fun and functional skill that retrieves cat-themed images and descriptions for any HTTP status code.
Agency Agents
A comprehensive library of over 18 domain-specific AI personas designed to provide expert-level workflows and professional identities for complex tasks.
Pilot Announce Capabilities
A specialized skill for broadcasting machine-readable service manifests and metadata to enable rich discovery within the Pilot Protocol network.
Featured*
