ocft

What This Skill Does

The OCFT (OpenClaw File Transfer) protocol provides a secure, decentralized mechanism for AI agents to exchange files directly through existing text-based message channels. By leveraging a chunked-transfer architecture, it bypasses the limitations of traditional chat platforms that often restrict file sizes or formats. The protocol automatically handles file splitting, reassembly, and integrity verification using SHA-256 hashing. For larger datasets, it integrates seamlessly with IPFS, ensuring that binary data is reliably accessible even if the direct message channel encounters throughput bottlenecks. OCFT acts as an abstraction layer, turning platforms like Discord, Slack, or Telegram into a secure peer-to-peer distribution network.

Installation

To begin, ensure you have the OpenClaw environment configured. Install the skill globally via your terminal by executing: npm install -g ocft. Once installed, you must initialize your node using ocft init, which generates the necessary cryptographic identity and secret tokens. Before connecting to peers, define your storage path using ocft set-download ./downloads. If you intend to use IPFS, execute ocft ipfs-enable and configure your chosen provider via ocft set-ipfs-provider. Always verify your setup with ocft status before initiating your first transfer.

Use Cases

OCFT is ideal for distributed AI workflows. You can use it to securely share large datasets between separate agent nodes without needing a centralized cloud server. It is perfect for teams of agents collaborating on research, where one agent generates a report and the other requires the raw CSV logs. Additionally, it provides a secure way to distribute configuration files or model checkpoints across peer nodes. By utilizing the whitelist-based trust system, you can ensure that only pre-authenticated agents can interact with your file system.

Example Prompts

1. "OCFT, please send the latest model checkpoint to my trusted peer with ID 0x8a92f... verify the transfer with SHA-256."
2. "OCFT, import the peer from this URI: ocft://eyJub2RlSWQxMjM0NTY3ODkwIiwic2VjcmV0IjoiYWJjZDEyMzQifQ== and set the trust expiry to 24 hours."
3. "OCFT, check my current storage settings and enable IPFS fallback for any file exceeding 50MB."

Tips & Limitations

Always manage your peer list cautiously; removing a peer immediately revokes their access. When dealing with sensitive data, ensure that your IPFS gateway is private or encrypted, as public gateways can expose file metadata. The 48KB chunk size is optimized for most message platforms, but keep in mind that high-latency networks may require longer transfer times. Always run ocft verify on secrets before establishing a long-term connection to prevent man-in-the-middle issues.