OCFT - OpenClaw File Transfer Protocol

P2P file transfer between AI agents via message channels.

When to Use

Use this skill when:

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

Protocol

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

Limitations

Links