OCFT - OpenClaw File Transfer
2026-03-30
新闻来源：网淘吧
围观:24
电脑广告
手机广告
OCFT - OpenClaw文件传输协议
通过消息通道在AI代理之间进行P2P文件传输。
何时使用
在以下情况使用此技能：
- 通过聊天通道在AI代理之间传输文件
- 与受信任的代理建立点对点文件共享
- 通过Telegram、Discord、Slack或任何基于文本的通道发送文件
- 需要带完整性验证的分块传输
- 使用IPFS回退机制传输大文件
安装
npm install -g ocft
快速开始
# Initialize your node (generates unique ID and secret)
ocft init
# View your status
ocft status
# Export your connection info to share with peers
ocft export
# Add a trusted peer
ocft add-peer <nodeId> <secret> --name "Friend"
# Or import from URI
ocft import ocft://eyJub2RlSWQ...
CLI命令
核心命令
| 命令 | 描述 |
|---|---|
ocft init | 使用唯一ID和密钥初始化节点 |
ocft status | 显示节点状态和配置 |
ocft show-secret | 显示完整密钥（请谨慎操作！） |
ocft export | 将连接信息导出为URI格式 |
ocft import <uri> | 从ocft:// URI导入对等节点 |
ocft verify <secret> | 验证密钥是否与您的匹配 |
对等节点管理
| 命令 | 描述 |
|---|---|
ocft add-peer <id> <secret> | 添加一个可信对等节点 |
ocft remove-peer <id> | 移除一个可信对等节点 |
ocft list-peers | 列出所有可信对等节点 |
ocft extend-peer <nodeId> <hours> | 延长对等节点的信任有效期 |
ocft set-ttl <hours> | 设置默认密钥有效期（0 = 永不过期） |
配置
| 命令 | 描述 |
|---|---|
ocft set-download <dir> | 设置下载目录 |
ocft set-max-size <大小> | 设置最大文件大小（例如：100MB、1GB） |
IPFS 回退（针对大文件）
| 命令 | 描述 |
|---|---|
ocft ipfs-enable | 为大文件启用 IPFS 回退 |
ocft ipfs-disable | 禁用 IPFS 回退 |
ocft set-ipfs-provider <提供商> | 设置提供商：pinata、filebase、kubo |
ocft set-ipfs-key <密钥> | 设置 IPFS API 密钥 |
ocft set-kubo-url <URL> | 设置 Kubo 节点 API URL |
ocft set-ipfs-threshold <size> | IPFS 的大小阈值（例如：50MB） |
ocft set-ipfs-gateway <url> | 设置自定义公共 IPFS 网关 |
功能特性
- 🔗基于消息：通过现有聊天渠道传输文件
- 📦分块传输：将大文件分割成小块（48KB 数据块）
- ✅完整性验证：对数据块和文件使用 SHA-256 哈希校验
- 🤝请求/接受：显式接受或自动接受策略
- 🔒安全性：带密钥的可信对等节点白名单
- ⏰密钥生存时间设置信任关系的过期时间
- 🔄恢复: 从最后一个数据块恢复中断的传输
- 🌐IPFS 回退: 对超过分块阈值的文件使用 IPFS
协议
OCFT 消息使用🔗OCFT:前缀及 Base64 编码的 JSON，允许通过任何基于文本的通道进行文件传输。
限制
- 分块大小：48KB（适用于消息中的 Base64 编码）
- 默认最大文件大小：100MB（可通过
set-max-size配置） - 专为基于文本的通道设计
- IPFS 回退需要提供商设置（Pinata、Filebase 或本地 Kubo）
链接
- GitHub:https://github.com/stormixus/ocft
- npmhttps://www.npmjs.com/package/ocfthttps://www.npmjs.com/package/ocft
微信扫一扫，打赏作者吧～文章底部电脑广告
手机广告位-内容正文底部
