介绍
# OCFT - OpenClaw File Transfer Protocol
通过消息通道在 AI 智能体之间进行 P2P 文件传输。
## 适用场景
在以下情况下使用此技能： - 通过聊天通道在 AI 智能体之间传输文件 - 与受信任的智能体建立对等文件共享 - 通过 Telegram、Discord、Slack 或任何基于文本的通道发送文件 - 需要进行完整性验证的分块传输 - 使用 IPFS 备选方案传输大文件
## 安装
```bash npm install -g ocft ```
## 快速开始
```bash # 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>` | 设置默认密钥 TTL（0 = 永不过期） |
### 配置
| 命令 | 描述 | |---------|-------------| | `ocft set-download <dir>` | 设置下载目录 | | `ocft set-max-size <size>` | 设置最大文件大小（例如 `100MB`、`1GB`） |
### IPFS 备选方案（用于大文件）
| 命令 | 描述 | |---------|-------------| | `ocft ipfs-enable` | 为大文件启用 IPFS 备选方案 | | `ocft ipfs-disable` | 禁用 IPFS 备选方案 | | `ocft set-ipfs-provider <provider>` | 设置提供商：`pinata`、`filebase`、`kubo` | | `ocft set-ipfs-key <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 哈希 - 🤝 **请求/接受**：明确接受或自动接受策略 - 🔒 **安全性**：具有密钥的受信任对等节点白名单 - ⏰ **密钥 TTL**：设置信任关系的过期时间 - 🔄 **恢复**：从最后一块恢复中断的传输 - 🌐 **IPFS 备选方案**：对超过块阈值的文件使用 IPFS
## 协议
OCFT 消息使用带有 Base64 编码 JSON 的 `🔗OCFT:` 前缀，允许在任何基于文本的通道上进行文件传输。
## 限制
- 块大小：48KB（消息中 Base64 安全大小） - 默认最大文件大小：100MB（可通过 `set-max-size` 配置） - 专为基于文本的通道设计 - IPFS 备选方案需要设置提供商（Pinata、Filebase 或本地 Kubo）
## 链接
- **GitHub**: https://github.com/stormixus/ocft - **npm**: https://www.npmjs.com/package/ocft