Back to Registry
View Author Profile
Official Verified
Node Transfer
Skill by eisonme
skill-install β Terminal
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/eisonme/node-transferOr
node-transfer
High-speed, memory-efficient file transfer between OpenClaw nodes using native Node.js streams.
π Table of Contents
- Problem Solved
- Architecture
- Requirements
- Installation
- Usage
- API Reference
- Troubleshooting
π― Problem Solved
The Original Problem
When transferring large files between OpenClaw nodes using the standard nodes.invoke mechanism, we encountered several critical issues:
| Issue | Impact |
|---|---|
| Base64 Encoding Overhead | 33% larger payload, slower transfers |
| Memory Exhaustion (OOM) | Loading multi-GB files into memory crashes the process |
| Transfer Latency | JSON serialization/deserialization adds significant delay |
| 9-Minute Deployments | Re-deploying scripts on every transfer |
The Solution
node-transfer uses native HTTP streaming with Node.js streams, providing:
- β Zero memory overhead - Files stream directly from disk to network
- β No Base64 encoding - Raw binary transfer
- β Speed - Line-speed limited only by network bandwidth
- β Install Once, Run Many - Scripts persist on nodes after first deployment
Performance Comparison
| Metric | Base64 Transfer | node-transfer | Improvement |
|---|---|---|---|
| 1GB file transfer time | ~15-30 min | ~8 sec | ~150x faster |
| Memory usage | 1GB+ | <10MB | 99% reduction |
| First transfer overhead | N/A | ~30 sec (one-time install) | - |
| Subsequent transfers | ~15-30 min | <1 sec check + ~8 sec transfer | ~200x faster |
ποΈ Architecture
How It Works
ββββββββββββββββ HTTP Stream ββββββββββββββββ
β send.js β ββββββββββββββββββββΊ β receive.js β
β (Source) β (Token-protected) β (Destination)β
ββββββββββββββββ ββββββββββββββββ
β β
βΌ βΌ
ββββββββββββββββ ββββββββββββββββ
β Read Stream β β Write Stream β
β (fs.create β β (fs.create β
β ReadStream)β β WriteStream)β
ββββββββββββββββ ββββββββββββββββ
β β
βΌ βΌ
ββββββββββββββββ ββββββββββββββββ
β File on β β File on β
β Disk β β Disk β
ββββββββββββββββ ββββββββββββββββ
Security Model
- One-time Token: 256-bit cryptographically random token (64 hex chars)
- Single Connection: Only one download allowed per token
- Auto-shutdown: Server closes after transfer completes or disconnects
- Token Validation: Every request must include the correct token
Data Flow
Metadata
AI Skill Finder
Not sure this is the right skill?
Describe what you want to build β we'll match you to the best skill from 16,000+ options.
Find the right skill Add to Configuration
Paste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-eisonme-node-transfer": {
"enabled": true,
"auto_update": true
}
}
}Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.