Source Code

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

npm install -g ocft

Quick Start

# 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)

ocft