node-transfer for Openclaw

A high-performance file transfer utility for OpenClaw nodes that uses native Node.js streaming to bypass memory limits and encoding overhead.

eisonme
v1.0.0
Feb 8, 2026
0
1.9k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install node-transfer

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 node-transfer 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 node-transfer?

node-transfer is a specialized utility designed to solve the performance bottlenecks of moving large files between nodes. By utilizing native Node.js HTTP streaming, it eliminates the 33% overhead caused by Base64 encoding and prevents Out-of-Memory (OOM) errors that typically occur when loading multi-gigabyte files into memory. This makes it an essential addition to your collection of Openclaw Skills, providing a robust architecture where data flows directly from disk to network.

Built with a focus on speed and efficiency, this skill enables line-speed transfers that are up to 150x faster than standard methods. It follows an install once, run many philosophy, allowing scripts to persist on nodes to minimize deployment latency for subsequent operations. Whether you are managing database dumps or large binary artifacts, node-transfer ensures your AI agent workflows remain fast and reliable.

node-transfer Use Cases

  • Transferring multi-gigabyte database backups between production and staging nodes without crashing processes.
  • Synchronizing large build artifacts or machine learning models across a distributed node network.
  • Automating secure, token-protected file exchanges between ephemeral node instances.
  • Reducing deployment overhead in CI/CD pipelines by using pre-installed transfer scripts.

How node-transfer Works

  1. The source node executes the send.js script, which generates a unique 256-bit security token and starts an ephemeral HTTP server.
  2. The sender outputs a JSON object containing the URL, security token, and file metadata.
  3. The destination node runs the receive.js script using the provided URL and token to establish a direct connection.
  4. Data is streamed using raw binary piping from the source disk to the destination disk, maintaining a memory footprint under 10MB.
  5. The sender server automatically shuts down after a successful transfer or a 5-minute timeout to ensure system security.

node-transfer Setup

To integrate this into your environment and leverage your Openclaw Skills effectively, use the deployment utility:

# Generate a deployment script for a target node
node deploy.js <NODE_ID>

For manual installation on target nodes, create the script directory and transfer the core files:

mkdir C:/openclaw/skills/node-transfer/scripts -Force
# Copy send.js, receive.js, ensure-installed.js, and version.js to this path

You can then verify the installation programmatically:

node ensure-installed.js C:/openclaw/skills/node-transfer/scripts

node-transfer Data Schema & Taxonomy

The skill utilizes structured JSON for coordinating transfers and reporting status. The primary metadata includes:

Field Type Description
url string The ephemeral HTTP endpoint for the receiver
token string A 64-character hex security token
fileSize number Total size of the transfer in bytes
speedMBps number Real-time or average transfer speed in MB/s
bytesReceived number Total bytes successfully written to the destination disk

node-transfer Advanced Features

  • Single-connection security model that invalidates tokens immediately after one successful download.
  • Ephemeral port negotiation (1024-65535) to prevent port conflicts and improve firewall traversal.
  • Real-time progress monitoring providing percentage completion and throughput metrics.
  • Integrity validation that checks received byte counts against original file sizes.
  • Version manifest system to ensure all nodes are running synchronized, up-to-date scripts.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*