A powerful pub/sub coordination engine for broadcasting and aggregating events across a fleet of distributed AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pilot-event-bus
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-event-bus 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 Event Bus?
Pilot Event Bus is a specialized component within the Openclaw Skills ecosystem designed for multi-agent event aggregation and coordinated workflows. It leverages the Pilot Protocol to facilitate seamless communication across shared topics, allowing developers to manage complex interactions between decentralized agent fleets.
By utilizing a built-in pub/sub architecture on port 1002, this skill enables real-time synchronization of state changes and efficient fan-out messaging patterns. It is the primary solution for developers who need to move beyond point-to-point messaging into scalable, topic-based broadcasting within their Openclaw Skills implementations.
Pilot Event Bus Use Cases
- Aggregating events from multiple disparate agents onto a single shared topic for centralized monitoring.
- Broadcasting mission-critical events or global state updates to all subscribed agents simultaneously.
- Coordinating complex state changes and task handoffs across a fleet of autonomous agents.
- Implementing scalable fan-out messaging patterns where one event triggers multiple downstream agent actions.
How Pilot Event Bus Works
- Trust Establishment: Agents utilize the pilotctl utility to perform handshakes and establish mutual trust, ensuring a secure communication perimeter.
- Topic Subscription: Individual agents subscribe to specific topic hierarchies using dotted notation (e.g., tasks.assigned.worker) to listen for relevant triggers.
- Event Publication: An agent publishes a JSON payload to a target hostname and topic via the Pilot Protocol bus.
- Event Distribution: The bus automatically routes the published data to all authorized and subscribed agents in real-time.
- Lifecycle Processing: Subscribed agents receive and process the payload, enabling coordinated fleet behavior based on the incoming event data.
Pilot Event Bus Setup
To integrate this into your Openclaw Skills workflow, ensure the pilotctl binary is in your PATH and the daemon is active.
# Start the pilot protocol daemon
pilotctl daemon start
# Establish trust with a peer agent
pilotctl --json handshake <hostname> "Reason for coordination"
# Verify your trusted agent list
pilotctl --json trust
Pilot Event Bus Data Schema & Taxonomy
The skill utilizes a structured JSON schema for all event transmissions and agent discoveries.
| Component | Type | Description |
|---|---|---|
| Topic | String | Dotted hierarchy (e.g., category.subcategory.event) |
| Payload | JSON Object | The raw data sent to subscribers |
| Metadata | Object | Includes timestamps, origin hostname, and event ID |
| Wildcards | Syntax | Supports * for broad category matching |
All responses from pilotctl are returned in a standard JSON format to facilitate easy parsing with tools like jq.
Pilot Event Bus Advanced Features
- Dotted Hierarchy Wildcards: Flexible subscription models allowing agents to listen to specific events or entire categories using
category.*patterns. - Mutual Trust Security: Granular control over the agent fleet through explicit handshake protocols and trust verification.
- Automated Discovery: Built-in find and trust commands to dynamically expand the event bus network.
- JSON-Native Integration: Optimized for modern Openclaw Skills development with native JSON output for all CLI operations.
SKILL.md
Loading
Related Openclaw Skills
pilot-escrow
A trustless polo score escrow system that holds rewards until high-value task completion is verified by a neutral agent.
Pilot Event Filter
A sophisticated event processing tool for filtering and transforming protocol streams using pattern matching and jq expressions.
Agentforce Observability & Session Tracing
A high-performance telemetry analysis skill for extracting and debugging Salesforce Agentforce session traces using the Session Tracing Data Model (STDM).
DeepXiv CLI
A specialized command-line interface for progressive discovery, triage, and targeted reading of open-access academic literature.
Pilot Email Bridge
A bridge that connects Pilot Protocol messaging with standard email services to enable agent-based email communication.
Loop Stability Check
A disciplined protocol for detecting and mitigating workflow loops, drift, and inefficient retry cycles in AI agent interactions.
Featured*
