putio

What This Skill Does

The putio skill serves as a command-line interface wrapper for managing your put.io cloud storage account within OpenClaw. By leveraging the 'kaput' CLI, this skill enables seamless management of remote file transfers, torrent handling, and cloud storage organization. It is designed to act as your primary control center for remote downloads, allowing you to queue files via magnet links or URLs and verify their status without ever leaving your terminal or chat interface. When paired with the 'chill-institute' skill, it creates a powerful automated pipeline for sourcing and storing content in the cloud.

Installation

To get started, ensure you have Rust and Cargo installed on your system. Run 'cargo install kaput-cli' to compile the necessary binaries. After installation, verify that the 'kaput' executable is available in your system's PATH. The skill handles authentication via an OAuth2 device-code flow; execute 'kaput login' and follow the provided URL and code instructions to secure your account. Once authenticated, the token is stored locally in your home directory. It is recommended to verify your setup using the provided scripts located in the 'skills/putio/scripts' directory.

Use Cases

This skill is ideal for power users who want to automate their media acquisition or file management workflows. You can initiate remote downloads by providing magnet links directly to the agent, monitor progress of active transfers without manually checking the web dashboard, and search through your existing file library. It is particularly useful for users who curate content on a headless server or who prefer keeping their browser clean from download manager extensions.

Example Prompts

1. 'OpenClaw, add this magnet link to my put.io transfers: [magnet:?xt=urn:btih:...]'
2. 'List all my current downloads on put.io and let me know which ones are finished.'
3. 'Search my put.io files for anything related to "project-backups" and show me the status of the account.'

Tips & Limitations

• The skill relies on local token persistence; if you rotate your keys or experience login issues, perform a clean re-auth using 'kaput login'.
• Avoid using 'kaput debug' in public logs, as this may leak sensitive information.
• Always ensure you have sufficient storage space on your put.io account before initiating large transfers.
• Integration with 'chill-institute' is highly recommended for a smoother, automated user experience, as it manages the 'sending' part of the workflow while 'putio' handles the storage and verification.