ocft

---
name: ocft
description: P2P file transfer between AI agents via message channels. Supports chunked transfer, IPFS fallback for large files, and trusted peer management.
homepage: https://github.com/stormixus/ocft
---

# OCFT - OpenClaw File Transfer Protocol

P2P file transfer between AI agents via message channels.

## When to Use

Use this skill when:
- Transferring files between AI agents over chat channels
- Setting up peer-to-peer file sharing with trusted agents
- Sending files through Telegram, Discord, Slack, or any text-based channel
- Need chunked transfer with integrity verification
- Transferring large files using IPFS fallback

## Installation

```bash
npm install -g ocft
```

## Quick Start

```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 Commands

### Core Commands

| Command | Description |
|---------|-------------|
| `ocft init` | Initialize node with unique ID and secret |
| `ocft status` | Show node status and configuration |
| `ocft show-secret` | Display full secret (careful!) |
| `ocft export` | Export connection info as URI |
| `ocft import <uri>` | Import peer from ocft:// URI |
| `ocft verify <secret>` | Verify if a secret matches yours |

### Peer Management

| Command | Description |
|---------|-------------|
| `ocft add-peer <id> <secret>` | Add a trusted peer |
| `ocft remove-peer <id>` | Remove a trusted peer |
| `ocft list-peers` | List all trusted peers |
| `ocft extend-peer <nodeId> <hours>` | Extend a peer's trust expiry |
| `ocft set-ttl <hours>` | Set default secret TTL (0 = no expiry) |

### Configuration

| Command | Description |
|---------|-------------|
| `ocft set-download <dir>` | Set download directory |
| `ocft set-max-size <size>` | Set max file size (e.g., `100MB`, `1GB`) |

### IPFS Fallback (for large files)

| Command | Description |
|---------|-------------|
| `ocft ipfs-enable` | Enable IPFS fallback for large files |
| `ocft ipfs-disable` | Disable IPFS fallback |
| `ocft set-ipfs-provider <provider>` | Set provider: `pinata`, `filebase`, `kubo` |
| `ocft set-ipfs-key <key>` | Set IPFS API key |
| `ocft set-kubo-url <url>` | Set Kubo node API URL |
| `ocft set-ipfs-threshold <size>` | Size threshold for IPFS (e.g., `50MB`) |
| `ocft set-ipfs-gateway <url>` | Set custom public IPFS gateway |

## Features

- 🔗 **Message-based**: Transfer files through existing chat channels
- 📦 **Chunked transfer**: Split large files into small pieces (48KB chunks)
- ✅ **Integrity verification**: SHA-256 hash for chunks and files
- 🤝 **Request/Accept**: Explicit acceptance or auto-accept policy
- 🔒 **Security**: Trusted peer whitelist with secrets
- ⏰ **Secret TTL**: Set expiry time for trust relationships
- 🔄 **Resume**: Resume interrupted transfers from last chunk
- 🌐 **IPFS Fallback**: Use IPFS for files exceeding chunk threshold

## Protocol

OCFT messages use a `🔗OCFT:` prefix with Base64-encoded JSON, allowing file transfers over any text-based channel.

## Limitations

- Chunk size: 48KB (safe for Base64 in messages)
- Default max file size: 100MB (configurable via `set-max-size`)
- Designed for text-based channels
- IPFS fallback requires provider setup (Pinata, Filebase, or local Kubo)

## Links

- **GitHub**: https://github.com/stormixus/ocft
- **npm**: https://www.npmjs.com/package/ocft