概述

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

版本历史

共 1 个版本

v1.1.2 当前

2026-03-28 12:31 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)