OCFT - OpenClaw File Transfer

P2P file transfer between AI agents via message channels. Supports chunked transfer, IPFS fallback for large files, and trusted peer management.

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)

Links

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