A specialized skill for deploying structured network topologies like star, ring, and mesh to organize AI agent communication within a swarm.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pilot-formation
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-formation 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-formation?
pilot-formation is a technical utility designed for the pilot-protocol ecosystem, enabling developers to move beyond ad-hoc agent connections toward structured, predictable network architectures. By leveraging this Openclaw Skills contribution, users can programmatically define how agents interact—whether through a centralized hub (Star), a circular consensus loop (Ring), or a fully redundant all-to-all connection (Mesh).
This skill is essential for scaling AI swarms where communication overhead and latency must be minimized. It provides the logic for automatic handshaking, trust establishment, and hierarchical organization, ensuring that agents can focus on task execution rather than networking boilerplate.
pilot-formation Use Cases
- Establishing a star topology for a central coordinator managing multiple worker agents.
- Creating a ring topology for agents performing sequential data processing or circular consensus.
- Building a high-redundancy mesh network for mission-critical decentralized swarms.
- Implementing hierarchical tree structures to organize large-scale agent groups into manageable sub-units.
How pilot-formation Works
- The skill identifies target peer addresses via the pilotctl binary using specific swarm or role metadata.
- It initiates a cryptographically secure handshake request to each identified peer to establish intent.
- The system monitors for pending connection requests and programmatically approves them to establish trust.
- Once the links are active, the skill validates the formation (e.g., ensuring all spokes are connected to the hub).
- Finally, it publishes the topology metadata to a central registry for discovery and persistent state management.
pilot-formation Setup
Ensure the pilot-protocol skill and pilotctl binary are installed on your system. The pilot daemon must be active.
# Start the pilot daemon if not running
pilotctl daemon start
# Verify dependencies are on PATH
which pilotctl jq
pilot-formation Data Schema & Taxonomy
The skill manages network state and peer metadata through JSON-formatted outputs. Key data objects include:
| Object | Description |
|---|---|
peers |
List of active agents with hostnames, addresses, and roles. |
pending |
Queue of unverified handshakes requiring approval. |
topology |
Metadata published to the registry defining the structure (type, hub, formed_at). |
node_id |
Unique identifier for agents used in the approval workflow. |
pilot-formation Advanced Features
- Multi-topology support: Quickly switch between Star, Ring, Mesh, Tree, and Line formations.
- Automated Trust Workflows: Batch approval of pending handshakes using JSON parsing.
- Registry Integration: Publish swarm state to external registries for cross-environment coordination.
- Granular Peer Filtering: Use role-based or swarm-based search queries to target specific agent subsets.
SKILL.md
Loading
Related Openclaw Skills
pilot-gossip
A decentralized protocol for achieving eventually-consistent state replication across AI agent swarms using epidemic-style communication.
Pilot GitHub Bridge
A bridge that translates GitHub webhook events into actionable Pilot Protocol messages for autonomous agents.
MiniMax MMX-CLI
A comprehensive command-line interface for AI agents to access MiniMax's full suite of multimodal capabilities including video, audio, and image generation.
Bias Audit
A disciplined decision-framing agent skill designed to surface cognitive biases and neutralize emotionally slanted requests before they harden into flawed decisions.
Pilot Event Log
A specialized skill for persistent NDJSON event logging featuring automated rotation, compression, and configurable retention policies.
Pilot Event Replay
A specialized utility for capturing event streams to NDJSON files and replaying them to simulate workloads or debug downstream consumers.
Featured*
