Pilot Presence provides real-time online, offline, and busy state tracking for agent fleets using high-performance ping and pub/sub mechanisms.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pilot-presence
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-presence 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 Presence?
Pilot Presence is a critical utility within the Openclaw Skills ecosystem designed for real-time monitoring and discovery of Pilot Protocol agents. It enables developers to maintain a live directory of agent availability, ensuring that task routing is always directed toward active and responsive nodes. By leveraging a robust pub/sub model, the skill allows agents to broadcast their status changes—such as shifting from online to busy—to all interested peers across the network.
This skill serves as the heartbeat of decentralized agent architectures, providing the necessary liveness checks and state synchronization required for complex multi-agent workflows. It bridges the gap between static peer discovery and dynamic fleet management, making it an essential component for any developer building scalable AI agent infrastructure using Openclaw Skills.
Pilot Presence Use Cases
- Tracking which agents in a distributed fleet are currently online, offline, or busy.
- Broadcasting real-time presence changes to peer agents to maintain synchronized state.
- Discovering available agents dynamically for efficient task routing and load balancing.
- Maintaining an automated, real-time agent directory for system-wide visibility.
How Pilot Presence Works
- The agent utilizes the pilotctl binary to initiate a liveness check via a ping command to target hostnames.
- Current status (e.g., online, busy) is encapsulated into a JSON payload including hostname and UTC timestamps.
- The agent publishes this presence data to a coordinator or peer network using the pilotctl publish command on the presence.status topic.
- Subscriber agents listen for presence.* updates to update their local directories of available peers.
- Continuous loops ensure status is heartbeated at regular intervals to detect silent failures or transitions to offline states.
Pilot Presence Setup
To utilize Pilot Presence within your Openclaw Skills environment, ensure you have the pilot-protocol skill installed and the pilotctl binary available on your PATH.
# Start the required pilot daemon
pilotctl daemon start
# Ensure jq is installed for JSON processing
sudo apt-get install jq
# Verify connection to the peer network
pilotctl --json peers
Pilot Presence Data Schema & Taxonomy
The skill organizes presence data using a structured JSON schema to ensure compatibility across the Pilot Protocol. Key metadata fields include:
| Field | Type | Description |
|---|---|---|
hostname |
String | The unique identifier for the reporting agent. |
status |
String | Current state: online, busy, offline, or away. |
timestamp |
ISO-8601 | The UTC time the status was recorded. |
Data is primarily handled through transient pub/sub messages, though local status files can be used to manage state between broadcast cycles.
Pilot Presence Advanced Features
- Wildcard Subscriptions: Use presence.* to monitor all status types or specific sub-topics simultaneously.
- Automated Presence Loops: Scripted heartbeats that dynamically read from local status files to update the fleet.
- Custom Presence States: Support for extending standard states (online/offline) with context-specific flags like 'away' or 'maintenance'.
- JSON-Native Integration: Seamless piping of presence data into jq for advanced filtering and automated decision-making within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
pilot-priority-queue
A priority-driven message delivery system for the Pilot Protocol network that ensures urgent communications are triaged and processed effectively.
Pilot Quarantine
A specialized incident response tool for Pilot Protocol networks that allows for the temporary isolation of suspicious agents within the framework of Openclaw Skills.
pilot-receipt
A tracking and audit trail extension for the Pilot Protocol that provides verifiable delivery and read receipts for inter-agent communication.
historical-sites
A professional AI agent skill for exploring global historical landmarks and ancient ruins with real-time booking capabilities.
Text-to-Image Short Drama Generator
A specialized text-to-image tool for creating high-definition 9:16 vertical frames optimized for short drama production.
Storyboard Prompt Generator
A specialized skill for converting script scenes into consistent, production-ready AI image generation prompts for storyboarding.
Featured*
