← Back to Skills Marketplace
oki3505f

Telegram Cloud Storage

by om yarewara · GitHub ↗ · v1.8.2
cross-platform ⚠ suspicious
2339
Downloads
2
Stars
4
Active Installs
4
Versions
Install in OpenClaw
/install telegram-cloud-storage
Description
A high-performance Telegram Cloud Storage solution using Teldrive. Turns Telegram into an unlimited cloud drive with a local API/UI.
Usage Guidance
This package appears to be a straightforward wrapper around Teldrive, but review these before installing: (1) Trust the binary source — the installer downloads a GitHub release; confirm the release and checksum if you need assurance. (2) Expect to provide Telegram App ID/Hash, a Postgres connection string, and a JWT secret — those are required for operation. (3) The Python client reads TELDRIVE_TOKEN and TELDRIVE_SESSION_HASH from env or token files; the registry metadata doesn't declare these env vars, so be aware of where tokens/sessions will be stored (config/token.txt and the DB). (4) setup.sh is interactive and uses simple sed substitutions that may break or mangle inputs containing special characters — avoid pasting complex secrets with newlines or problematic characters, or edit config/config.toml by hand. (5) Check how the server binds (network exposure) and ensure you do not expose the service publicly without authentication and a strong JWT secret. (6) If you have low trust in the publisher, run the skill in an isolated environment (container/VM) and inspect the downloaded teldrive release before running.
Capability Analysis
Type: OpenClaw Skill Name: telegram-cloud-storage Version: 1.8.2 The skill is classified as suspicious primarily due to `scripts/install_binary.sh` which downloads and executes a remote binary from GitHub. While the source (`https://github.com/tgdrive/teldrive`) appears official for the stated purpose, downloading and executing code from an external source is a high-risk operation that could be exploited in a supply chain attack if the remote repository were compromised. Additionally, the skill handles sensitive credentials like Telegram API keys, database connection strings, and JWT secrets, which, while necessary for its functionality, represent a significant attack surface if the skill itself were compromised.
Capability Assessment
Purpose & Capability
Name/description match the files and scripts: the skill bundles a Teldrive binary installer, setup, management scripts, and a Python client to talk to a local Teldrive server. The declared need for a database and Telegram API credentials is appropriate for Teldrive.
Instruction Scope
Runtime instructions operate on the skill directory (create config, install binary, start/stop service) and the Python client talks only to localhost:8080. The SKILL.md and client reference TELDRIVE_TOKEN and TELDRIVE_SESSION_HASH for operations, but these env vars are not listed in registry metadata. setup.sh is interactive and uses sed replacements (fragile for inputs with special chars). No instructions request unrelated system files or external endpoints other than the GitHub release URL and localhost API.
Install Mechanism
Install uses an exec script that downloads a tarball from a GitHub releases URL (https://github.com/tgdrive/teldrive/releases/...). This is a common/traceable source and the script extracts and installs a binary into the skill's bin/ directory. Minor inconsistency: the installer hardcodes VERSION=1.8.0 while the skill registry version is 1.8.2.
Credentials
The skill legitimately requires Telegram App ID/Hash, a Postgres connection string, and a JWT secret (all collected by setup.sh). The client uses TELDRIVE_TOKEN and TELDRIVE_SESSION_HASH, but the registry lists no required env vars — this mismatch should be corrected so users know which secrets are needed. Requested credentials are proportional to the functionality (they are necessary for Teldrive operation).
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide agent settings. It writes files within its own directory (bin/, config/, logs/, pidfile) and starts the Teldrive process; this is expected behavior for a self-contained service.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install telegram-cloud-storage
  3. After installation, invoke the skill by name or use /telegram-cloud-storage
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.8.2
Final clean release. Rebuilt with Teldrive 1.8.0 engine. Credits to tgdrive/teldrive.
v1.8.1
Fixed security leak in previous version. Rebuilt from scratch with Teldrive 1.8.0 engine. Credits to tgdrive/teldrive.
v1.8.0
Rebuilt from scratch with Teldrive 1.8.0. High performance, AI client included, and easier setup instructions. Credits to tgdrive/teldrive.
v0.1.0
Initial release of Telegram Cloud Storage skill. - Enables agents to use Telegram as an unlimited, distributed cloud storage backend with auto-chunking, encryption, and multi-bot support. - Provides Python CLI commands for uploading, downloading, listing, and deleting files. - Stores all metadata locally with Postgres for privacy and persistence. - Includes setup instructions for building the backend and running required services. - Designed for agent workflows needing scalable, persistent storage beyond local disk limits.
Metadata
Slug telegram-cloud-storage
Version 1.8.2
License
All-time Installs 4
Active Installs 4
Total Versions 4
Frequently Asked Questions

What is Telegram Cloud Storage?

A high-performance Telegram Cloud Storage solution using Teldrive. Turns Telegram into an unlimited cloud drive with a local API/UI. It is an AI Agent Skill for Claude Code / OpenClaw, with 2339 downloads so far.

How do I install Telegram Cloud Storage?

Run "/install telegram-cloud-storage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Telegram Cloud Storage free?

Yes, Telegram Cloud Storage is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Telegram Cloud Storage support?

Telegram Cloud Storage is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Telegram Cloud Storage?

It is built and maintained by om yarewara (@oki3505f); the current version is v1.8.2.

💬 Comments