TeraBox Storage Skill

TeraBox cloud storage management tool supporting upload, download, transfer, share, and file listing. All operations are restricted to the application sandbox directory.

Compatible with: OpenClaw, Claude Code, DuClaw, Ducc, etc.

Beta stage - see reference/notes.md for important notes

Installation

If the terabox CLI tool is not installed, run the installation script:

CODEBLOCK0

The script will:

1. 1. Detect your OS and architecture
2. Download the terabox binary from CDN
3. Install it to INLINECODE1

Make sure ~/.local/bin is in your PATH:

CODEBLOCK1

Trigger Rules

Execute only when BOTH conditions are met:

1. 1. User explicitly mentions TeraBox - message contains "TeraBox", "terabox", "Tera", etc.
2. Clear operation intent - can determine one of: upload, download, transfer, share, list, login, logout

Do NOT execute any terabox commands if conditions are not met.

Confirmation Rules

Must confirm with user first in these scenarios:

Confirmation format:

CODEBLOCK2

Pre-execution Checks

Before every terabox command:

1. 1. Run Skill auto-update (silently, do not block on failure):

1. 2. Run terabox whoami to check login status; if not logged in, guide user to INLINECODE5
2. Validate path legality (no ../, path must be within application sandbox)

Core Features

Upload

CODEBLOCK3

Supports single file and directory upload. When uploading a directory, all files are recursively uploaded.

Steps: Confirm local path exists → Confirm remote path → Use terabox ls to check if remote exists → Execute upload

Download

CODEBLOCK4

Supports single file and directory download. When downloading a directory, all files are recursively downloaded.

Steps: Use terabox ls to confirm cloud path exists → Confirm local path → Check if local exists → Execute download

Transfer (Save shared files to your cloud storage)

CODEBLOCK5

Steps: Validate link format → Confirm password exists → Confirm target directory → Execute transfer

Share Operations

CODEBLOCK6

File Operations

CODEBLOCK7

User Information

CODEBLOCK8

Update CLI

CODEBLOCK9

The CLI also checks for updates automatically on every command execution. Use --no-check-update global flag to disable this behavior.

Login

Must use the login script:

CODEBLOCK10

Requirements:

• - Must use @skills/terabox-storage/scripts/login.sh script
• Do NOT use terabox login directly (even in GUI environments)

The login script includes complete security disclaimers and authorization flow to ensure informed user consent.

Logout

CODEBLOCK11

Path Rules

All remote paths are relative to the application sandbox directory /From：Other Applications/app-name/.

Prohibited:

• - Paths containing .. or INLINECODE15
• Paths outside the application sandbox

Reference Documentation

See the reference directory for detailed information (consult when encountering issues):