⚠
High Risk:This skill has significant security concerns. Review the findings below before installing.

telegram-cloud-storage

⚠Caution·Scanned 2/18/2026

High-risk skill: installs and runs shell scripts and downloads/extracts a remote binary from https://github.com/tgdrive/teldrive/releases/download/$VERSION/teldrive-$VERSION-linux-amd64.tar.gz, then runs bin/teldrive. It also reads/writes credentials into config/config.toml and uses TELDRIVE_TOKEN/TELDRIVE_SESSION_HASH to contact http://localhost:8080/api.

from clawhub.ai·vf19c08a·10.8 KB·0 installs
Scanned from 1.8.2 at f19c08a · Transparency log ↗
$ vett add clawhub.ai/oki3505f/telegram-cloud-storageReview security findings before installing

Telegram Cloud Storage (Teldrive Edition)

This skill runs Teldrive, a powerful utility that organizes Telegram files and provides a high-speed API/UI for accessing them.

Features

  • Unlimited Storage: Uses Telegram as a backend.
  • High Performance: Written in Go, optimized for speed.
  • UI & API: Includes a web interface and REST API.
  • AI-Native Client: Includes client.py for agent-based file operations.

Credits

This skill is a wrapper for Teldrive by divyam234. All credit for the core engine goes to the original authors.

Requirements

  1. PostgreSQL Database: Version 17+ recommended.
  2. pgroonga Extension: Required for file search within Postgres.
  3. Telegram API: App ID and Hash from my.telegram.org.

Installation

1. Database Setup

Ensure Postgres is running and the pgroonga extension is installed.

CREATE DATABASE teldrive;
\c teldrive
CREATE EXTENSION IF NOT EXISTS pgroonga;

2. Configure

Run the setup script to generate config/config.toml:

./scripts/setup.sh

3. Start Server

./scripts/manage.sh start

Agent Usage

The skill includes a Python client for programmatic access.

Environment Variables

  • TELDRIVE_TOKEN: Your JWT token (get this from the UI or config/token.txt after login).
  • TELDRIVE_SESSION_HASH: Your Telegram session hash (found in the teldrive.sessions table).

Commands

# List files
python3 scripts/client.py list /

# Upload a file
python3 scripts/client.py upload local_file.txt /remote/path

# Download a file
python3 scripts/client.py download <file_id> local_save_path

Directory Structure

  • bin/: Teldrive binary.
  • config/: Configuration templates and generated config.
  • scripts/: Setup, management, and client scripts.
  • logs/: Application logs.