node-transfer

node-transfer 是一款专为 OpenClaw 分布式节点设计的高性能文件传输工具，通过原生 Node.js HTTP 流技术彻底解决了传统 Base64 编码传输的效率瓶颈。

核心用法 采用"一次部署，多次运行"的智能模式。首次使用时通过 deploy.js 将传输脚本部署到目标节点（约 30 秒），后续通过 ensure-installed.js 进行毫秒级版本校验。实际传输时，发送端执行 send.js 启动临时 HTTP 服务器并生成 256 位随机 Token，接收端通过 receive.js 建立直连流式下载。整个过程无需 Base64 编解码，文件直接从磁盘流式传输至网络，内存占用恒定在 10MB 以下。

显著优点 体现在性能与资源占用的双重突破。相比传统 Base64 传输，该工具实现约 150 倍速度提升（1GB 文件从 15-30 分钟缩短至 8 秒），内存占用降低 99%。其安全模型设计严谨：单次有效的加密 Token、传输完成后自动关闭服务器、5 分钟超时机制有效防止资源泄露。此外，纯内置模块依赖（零 npm 包）确保了供应链安全。

潜在局限 主要包括传输层安全与功能边界。当前版本使用 HTTP 明文传输（非 HTTPS），虽适用于内部可信网络，但不建议跨公网使用。文件传输为一次性会话，不支持断点续传功能。作为 T3 级社区来源工具，虽代码已开源可审计，但非 OpenClaw 官方维护，长期支持存在不确定性。

适用群体 主要为 OpenClaw 生态下的 DevOps 工程师、后端开发者及运维团队，特别是需要频繁在节点间同步大体积文件（如日志、数据库备份、容器镜像）且受限于内存资源的场景。

使用风险 集中在网络环境与权限管理。需确保节点间 TCP 连通性（端口 1024-65535）及防火墙放行，传输中断可能导致部分文件残留（虽有自动清理机制）。接收端默认具备目录创建权限，需防范路径遍历风险（已通过 path.resolve() 缓解）。建议在隔离的本地网络环境中使用，避免敏感数据通过明文 HTTP 传输。