🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί OCFT - OpenClaw File Transfer
πŸ¦€ ClawHub

OCFT - OpenClaw File Transfer

by @stormixus

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

Versionv1.1.2
Downloads3,014
Installs3
Stars⭐ 1
#coding#legal#productivity
TERMINAL
clawhub install ocft

πŸ“– About This Skill

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

    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   --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 | Import peer from ocft:// URI | | ocft verify | Verify if a secret matches yours |

    Peer Management

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

    Configuration

    | Command | Description | |---------|-------------| | ocft set-download

    | Set download directory | | ocft set-max-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 | Set provider: pinata, filebase, kubo | | ocft set-ipfs-key | Set IPFS API key | | ocft set-kubo-url | Set Kubo node API URL | | ocft set-ipfs-threshold | Size threshold for IPFS (e.g., 50MB) | | ocft set-ipfs-gateway | 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

    • ⚑ When to Use

    TriggerAction
    - 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

    πŸ’‘ Examples

    # 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   --name "Friend"
    Or import from URI
    
ocft import ocft://eyJub2RlSWQ...

    βš™οΈ Configuration

    | Command | Description | |---------|-------------| | ocft set-download

    | Set download directory | | ocft set-max-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 | Set provider: pinata, filebase, kubo | | ocft set-ipfs-key | Set IPFS API key | | ocft set-kubo-url | Set Kubo node API URL | | ocft set-ipfs-threshold | Size threshold for IPFS (e.g., 50MB) | | ocft set-ipfs-gateway | Set custom public IPFS gateway |