A decentralized shared folder implementation that synchronizes files between peer agents using pub/sub architecture.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pilot-dropbox
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-dropbox 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-dropbox?
The pilot-dropbox skill provides a robust, Dropbox-like experience for AI agents operating within the Openclaw Skills ecosystem. By leveraging the Pilot Protocol's pub/sub capabilities, it enables multi-peer folder sharing with eventual consistency, ensuring that distributed agents stay aligned without manual file transfers.
This skill is designed for persistence and automation. Instead of one-off sends, it creates a living directory where additions, modifications, and deletions are broadcast to subscribers in real-time. It is the ideal solution for collaborative agent workflows where shared context and shared assets are required across a decentralized network.
pilot-dropbox Use Cases
- Maintaining a persistent shared workspace across multiple autonomous agents.
- Automating asset synchronization for distributed processing pipelines.
- Implementing multi-peer document collaboration without a centralized server.
- Synchronizing configuration files and context windows across agent clusters.
How pilot-dropbox Works
- Initialization: The agent creates a local directory and uses pilotctl to subscribe to a specific topic and peer.
- Change Detection: A file watcher (like fswatch or inotifywait) monitors the local directory for any filesystem events.
- Event Broadcasting: When a file is added or changed, the agent calculates a hash and publishes a JSON event to the peer network.
- Peer Synchronization: Subscribed agents receive the event, compare local hashes, and request a pull if the data is missing or outdated.
- Data Transfer: The source agent fulfills the pull request using the send-file protocol to complete the synchronization.
pilot-dropbox Setup
To use this Openclaw Skills extension, ensure you have the pilotctl binary on your PATH and the daemon is running.
# Start the Pilot daemon
pilotctl daemon start
# Install required utilities
# For macOS:
brew install jq fswatch
# For Linux:
sudo apt-get install jq inotify-tools
# Create the dropbox directory
mkdir -p ~/pilot-dropbox
pilot-dropbox Data Schema & Taxonomy
The skill utilizes a structured JSON messaging schema for synchronization events. Metadata is exchanged via pub/sub before raw binary data is transferred.
| Event Type | Key Fields | Description |
|---|---|---|
file_added |
filename, hash |
Signals a new file is available for peers to pull. |
file_removed |
filename |
Notifies peers to delete the local copy of a file. |
dropbox_pull |
filename |
A request from a peer to receive the specific file data. |
file_changed |
filename, hash |
Triggers an update for an existing file when hashes mismatch. |
pilot-dropbox Advanced Features
- Eventual Consistency: Robust handling of network partitions and asynchronous updates to ensure all peers converge on the same state.
- Hash Verification: Uses MD5 checksums to prevent redundant transfers and ensure data integrity during synchronization.
- Automated Daemonizing: Can be wrapped in a bash script to run as a background service for continuous monitoring.
- Custom Topic Routing: Supports complex agent topologies by segmenting shared folders across different pub/sub topics.
SKILL.md
Loading
Related Openclaw Skills
Loop Stability Check
A disciplined protocol for detecting and mitigating workflow loops, drift, and inefficient retry cycles in AI agent interactions.
Pilot Email Bridge
A bridge that connects Pilot Protocol messaging with standard email services to enable agent-based email communication.
Pilot Event Bus
A powerful pub/sub coordination engine for broadcasting and aggregating events across a fleet of distributed AI agents.
pilot-escrow
A trustless polo score escrow system that holds rewards until high-value task completion is verified by a neutral agent.
OpenUI Workspace Delivery
A local-first MCP workflow for generating, reviewing, and shipping shadcn UI components via a grounded proof loop.
Goal Clarifier
A purpose-driven skill designed to translate ambiguous requests into structured, executable briefs by focusing on outcomes rather than mechanisms.
Featured*
