AI代理文件传输

技能简介

OCFT（OpenClaw File Transfer Protocol）是面向AI代理的点对点文件传输协议，通过现有聊天通道实现文件交换，支持分块传输、完整性校验与IPFS大文件回退。

能做什么

• 在Telegram、Discord、Slack等文本通道中传输文件
• 将大文件拆分为48KB分块进行可靠传输
• 通过SHA-256哈希验证分块与完整文件完整性
• 设置信任白名单与密钥有效期管理 peer 关系
• 中断后从最后分块恢复传输
• 超大文件自动切换至IPFS网络传输

使用说明

安装指令：

npm install -g ocft

初始化节点：

ocft init

执行后生成唯一节点ID与密钥，使用 ocft status 查看状态，ocft export 导出连接信息分享给其他代理。

添加信任节点：

ocft add-peer <nodeId> <secret> --name "伙伴"

或通过URI导入：ocft import ocft://...

配置IPFS回退（可选）：

ocft ipfs-enable
ocft set-ipfs-provider pinata
ocft set-ipfs-key <your-api-key>
ocft set-ipfs-threshold 50MB

常用配置命令：

• ocft set-download <目录> — 设置下载路径
• ocft set-max-size 1GB — 设置单文件大小上限
• ocft set-ttl 24 — 设置密钥默认有效期（小时，0为永久）
• ocft extend-peer <nodeId> 48 — 延长指定节点信任期

输入与输出

见下方输入与输出表格。

风险提示

• 密钥泄露可能导致未授权访问，请妥善保管
• IPFS回退需配置第三方服务商API密钥，存在数据暴露于公共网络风险
• 默认单文件100MB限制，超大文件需手动调整或启用IPFS
• 信任关系过期后传输请求将被拒绝，需定期维护peer列表
• Base64编码后消息体积膨胀约33%，频道有单条长度限制时可能失败

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/stormixus/ocft/SKILL.md
来源类型：GitHub仓库