File Sender for Openclaw

The File Sender skill enables AI agents to package workspace files into ZIP archives and deliver them to users with descriptive metadata.

whyhit2005
v1.0.0
Apr 2, 2026
0
698
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install file-sender

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 file-sender 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 File Sender?

The File Sender is a robust utility designed for Openclaw Skills that bridges the gap between agent-generated workspace content and end-user delivery. It automates the process of compressing deliverables—such as code projects, PDF reports, or data exports—and ensures they are safely transferred to the user via a managed notification system.

By using this skill, agents can proactively provide tangible artifacts, enhancing the overall productivity of the AI interaction. The system prioritizes data integrity by persisting files locally in a dedicated .file-outbox directory before notifying the management layer. This ensures that even if a network interruption occurs, the deliverables remain secure and ready for subsequent delivery attempts.

File Sender Use Cases

  • Delivering a completed coding project after generating multiple files.
  • Exporting data analysis reports or generated PDF documents.
  • Responding to user requests like "send me the files" or "package for download".
  • Proactively handing off modified workspace assets upon task completion.

How File Sender Works

  1. The agent composes a detailed description of the generated deliverables and their purpose.
  2. The packaging script is executed, providing the source directory or file path and the description string.
  3. The system validates the path within the workspace to ensure security and creates a ZIP archive (supporting files up to 500MB).
  4. Deliverables are persisted in the .file-outbox directory alongside a summary text file for local redundancy.
  5. A lightweight notification is sent to the Openclaw Skills manager to initiate the file retrieval process.
  6. The background manager pulls the package from the agent and completes the delivery to the user interface.

File Sender Setup

The File Sender skill requires specific environment variables which are typically auto-injected by the environment manager. Ensure the following binaries are available in your environment:

# Check for required dependencies
which curl zip

To send a directory, use the provided shell script within your agent workflow:

bash scripts/send-files.sh "/home/node/workspace/your_project" "Description of your files"

File Sender Data Schema & Taxonomy

The skill organizes outgoing deliverables within a local directory named .file-outbox/. Each delivery transaction generates two specific files to ensure traceability within the Openclaw Skills ecosystem:

File Pattern Description
{timestamp}_{id}.zip The compressed archive containing the workspace files or directories.
{timestamp}_{id}.txt A human-readable text file containing the delivery description and metadata.

File Sender Advanced Features

  • Local persistence ensures no data loss even if the manager notification fails initially.
  • Automatic recursive zipping handles complex directory structures without manual configuration.
  • Integrated security validation prevents symlink traversal and restricts access to the workspace scope.
  • Fail-safe delivery mechanisms allow the system to retry notifications automatically until the user receives the files.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*