pilot-share for Openclaw

A high-reliability file sharing skill for AI agents that features progress tracking and automatic retry logic over the Pilot Protocol.

teoslayer
v1.0.0
Apr 9, 2026
0
840
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install pilot-share

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install pilot-share 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-share?

pilot-share is a specialized tool within the Openclaw Skills ecosystem designed for one-shot file and directory transfers between autonomous agents. It prioritizes reliability and transparency, providing developers with clear progress indicators and confirmation for every transfer. Unlike simple copy commands, it is built to handle the complexities of inter-agent communication, ensuring that data reaches its destination even in unstable environments.

By leveraging the pilot-protocol, this skill ensures that agents can exchange assets, documents, and archives with minimal overhead. It is the ideal solution for workflows where a single, discrete transfer is required rather than continuous synchronization, making it a staple for modular agent architectures.

pilot-share Use Cases

  • Sharing specific documents or logs with a peer agent for analysis.
  • Transferring compressed directories or project folders as one-off archives.
  • Reliable data exfiltration in environments where transfer failures require automated recovery.
  • Providing agents with a mechanism to send progress reports and artifacts to a central controller.

How pilot-share Works

  1. The agent identifies the destination address and the local path of the file or directory to be shared.
  2. For directories, the skill wraps the content into a compressed archive to maintain structure and reduce transfer size.
  3. The pilotctl binary is invoked to initiate the transfer over the Pilot Protocol daemon.
  4. The system monitors the transfer progress and validates the success of the operation via JSON output.
  5. If a failure occurs, the integrated retry logic automatically re-attempts the transfer until completion or a maximum retry limit is reached.

pilot-share Setup

To utilize pilot-share as part of your Openclaw Skills deployment, ensure the pilotctl binary is in your PATH and the daemon is active.

# Start the required pilot daemon
pilotctl daemon start

# Ensure dependencies are installed
# Requires: pilotctl, jq, and tar

pilot-share Data Schema & Taxonomy

The skill manages transfers through the pilotctl interface, producing structured JSON responses to track the state of shared assets.

Attribute Description Type
success Boolean flag indicating if the transfer completed Boolean
filename The name of the file or archive being shared String
size Total size of the transfer in bytes Integer
timestamp ISO-8601 formatted string of the transfer event String
received A list of incoming shares visible to the agent Array

pilot-share Advanced Features

  • Automatic retry mechanism to handle intermittent network or protocol interruptions.
  • JSON-first output format for seamless integration with jq and other automation tools.
  • Support for directory archiving on-the-fly using tar compression.
  • Integration with pilot-protocol for secure, addressed routing between specific agent IDs.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*