A security-focused skill for maintaining and synchronizing blocklists of untrusted agents within Pilot Protocol networks.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pilot-blocklist
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-blocklist 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 Blocklist?
Pilot Blocklist is a specialized tool designed to fortify the security of agent-to-agent interactions within Pilot Protocol environments. It provides developers using Openclaw Skills with the necessary mechanisms to maintain a persistent and shareable deny-list of malicious or compromised agents. By centralizing the management of untrusted nodes, this skill ensures that unauthorized or harmful entities are systematically prevented from establishing connections or performing actions across your distributed network.
This skill is particularly valuable for network administrators and developers who need to implement automated security policies. It works in tandem with the core Pilot Protocol to automate the identification and rejection of threats, ensuring that your Openclaw Skills deployment remains resilient against spam and bad actors.
Pilot Blocklist Use Cases
- Blocking malicious or compromised agents from connecting to your node.
- Sharing standardized blocklists across multiple agents in a federated network.
- Maintaining a persistent audit trail of denied agents and the reasons for their exclusion.
- Automatically enforcing network security by rejecting handshakes from known bad hostnames.
How Pilot Blocklist Works
- Initializes a secure JSON-based repository in the user's home directory to store blocklist entries.
- Queries the Pilot Protocol network via the pilotctl binary to resolve hostnames into unique node IDs.
- Updates the blocklist data structure with agent metadata, including the reason for the block and a UTC timestamp.
- Invokes pilotctl commands to explicitly untrust and reject the target node ID from the current environment.
- Monitors pending network handshakes and cross-references them against the blocklist to automate rejection of blacklisted entities.
Pilot Blocklist Setup
To integrate this capability into your Openclaw Skills setup, ensure you have the pilotctl binary installed and the daemon running. Then, initialize the local blocklist storage:
mkdir -p ~/.pilot/blocklists
cat > ~/.pilot/blocklists/default.json <<EOF
{"name":"default","description":"Primary blocklist","entries":[]}
EOF
Pilot Blocklist Data Schema & Taxonomy
The skill organizes its security data in a structured JSON format to ensure compatibility and ease of sharing between Openclaw Skills agents. Files are stored in ~/.pilot/blocklists/ with the following entry schema:
| Property | Type | Description |
|---|---|---|
hostname |
String | The human-readable network address of the agent. |
node_id |
String | The unique cryptographic identifier in the Pilot network. |
reason |
String | Detailed context on why the agent was added to the blocklist. |
blocked_at |
Timestamp | ISO-8601 formatted date and time of the block action. |
Pilot Blocklist Advanced Features
- Scripted enforcement workflows that automatically block agents with low Polo scores.
- Multi-agent synchronization capabilities to distribute threat intelligence across a cluster.
- Automated handshake filtering to pre-emptively reject connections from blocked hostnames.
- Deduplication logic to maintain clean and efficient blocklist entries across large networks.
SKILL.md
Loading
Related Openclaw Skills
pilot-broadcast
A decentralized pub/sub messaging skill for broadcasting announcements and status updates to trusted agent networks.
Pilot Chunk Transfer
A robust large-file transfer skill providing automatic data segmentation, interrupted transfer resumption, and checksum-based integrity verification.
pilot-chat
A lightweight messaging skill for direct, asynchronous or synchronous text communication between autonomous AI agents.
CraveGo Campaign Planner
An AI-powered marketing strategist for CraveGo.ph that generates 4-week signup-focused content calendars and cross-platform promo angles.
Sanna Governance
Sanna Governance provides constitution-based enforcement and cryptographic receipts for AI agent tool calls to ensure safety, compliance, and transparent audit trails.
Market Intelligence Agent
An automated research tool that mines social platforms and community forums to identify high-value business opportunities and validate startup ideas.
Featured*
