A CLI-based storage solution that mounts AWS S3 as a local filesystem via WebDAV, enabling AI agents to manage files using standard Unix commands.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pidrive
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 pidrive 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 pidrive?
pidrive is a specialized private file storage utility built specifically for the needs of AI agents. It bridges the gap between cloud persistence and local execution by mounting an AWS S3 bucket as a local filesystem via WebDAV. This allows agents to interact with remote storage using familiar Unix commands like ls, cat, grep, and cp, removing the need for complex SDKs or API integrations. As a featured tool in the Openclaw Skills ecosystem, it simplifies how autonomous agents handle persistent data across ephemeral environments.
By providing a mounted drive interface, pidrive ensures that all agent-generated data is stored securely in the cloud while maintaining a small local read cache for performance. The architecture isolates every agent, ensuring private storage by default while offering robust sharing mechanisms for collaborative workflows. It is the ideal solution for developers building with LangChain, CrewAI, or AutoGPT who require a simple, scriptable way to persist agent state.
pidrive Use Cases
- Providing persistent storage for AI agents running in ephemeral containers or VMs.
- Sharing logs, reports, or datasets between different agents securely.
- Enabling full-text search across large volumes of agent-generated text files.
- Creating temporary public download links for files produced by autonomous workflows.
- Streamlining file ingestion for AI agents using standard Unix pipes and redirects.
How pidrive Works
- The pidrive CLI connects the host environment to a remote server using WebDAV over HTTPS.
- Authentication is handled via a unique API key sent through HTTP Basic Auth over a TLS-encrypted connection.
- The server maps the agent's session to a dedicated private directory within an AWS S3 bucket.
- Standard file system operations performed by the agent are translated into WebDAV requests and executed against the S3 backend.
- A local cache (via davfs2 on Linux or native macOS mount) optimizes read performance for recently accessed files.
- Data remains persistent in S3 even if the local environment or VM is destroyed, allowing for easy recovery upon remounting.
pidrive Setup
Install the CLI tool using Homebrew on macOS or Linux:
brew tap abhishek203/pidrive
brew install pidrive
For Linux users, ensure davfs2 is installed for mount support:
sudo apt install davfs2
Register your agent and mount the drive:
pidrive register --email [email protected] --name "Agent001" --server https://pidrive.ressl.ai
pidrive verify --email [email protected] --code <verification_code>
pidrive mount
pidrive Data Schema & Taxonomy
Upon mounting, the drive is organized into two primary directories accessible at /drive/ (Linux) or ~/drive/ (macOS):
| Path | Access | Description |
|---|---|---|
/my/ |
Read/Write | Private storage area for the authenticated agent. |
/shared/ |
Read-Only | Contains files shared by other agents, organized by the sender's email address. |
All persistent data is stored as objects in AWS S3, while the CLI manages metadata for shares, trash retention, and indexing.
pidrive Advanced Features
- Background indexing of text files for high-speed full-text search via the CLI.
- Reference-based sharing that allows recipients to view live file updates without creating duplicates.
- Granular sharing controls including direct email-based shares or public links with expiration timers.
- Integrated trash management that retains deleted files for 30 days before permanent removal.
- Native support for Unix pipes, allowing agents to stream data directly into cloud storage.
SKILL.md
Loading
Related Openclaw Skills
SkillBoss Multi-Model AI Hub
Access 50+ AI models for chat, media generation, and developer tools via a single API key through Openclaw Skills.
SkillBoss: Universal AI API Hub
A unified API gateway providing access to over 50 leading AI models for text, image, video, audio, and specialized automation tasks through a single interface.
Video-Generator-SeeDance
An advanced AI video generation skill leveraging the Volcengine SD1.5pro API for automated text-to-video and image-to-video production.
Weekly Ops Review
A high-performance automation tool that synthesizes fragmented tasks, metrics, and notes into professional weekly operating reviews.
Agent Architecture Evaluator
A comprehensive diagnostic tool for reviewing, testing, and optimizing the structural integrity of complex agentic architectures and multi-agent systems.
NVIDIA NemoClaw
A secure orchestration plugin for running always-on AI assistants in policy-enforced sandboxes using NVIDIA OpenShell.
Featured*
