← Back to Skills Marketplace
642
Downloads
2
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install tsend
Description
Send files quickly via Telegram using the tsend CLI tool with optional captions, profiles, and simple token/chat ID configuration.
Usage Guidance
This skill is coherent and appears to do what it says: a local CLI that sends files to Telegram using a bot token and chat ID. Before installing or using it: 1) Inspect the included code if you can — it is bundled and readable (no obfuscated code). 2) Be aware the tool will store your bot token and chat ID in plaintext at ~/.tsend/config.json unless you supply them via environment variables (TSEND_TOKEN, TSEND_CHAT_ID) or pass them on the command line. Only use a bot token you trust and avoid sending sensitive files through the tool. 3) Installation requires you to run uv tool or pip install -e ., which modifies your Python environment and registers the tsend command — consider installing in a virtualenv if you want isolation. 4) There are no unexpected external endpoints beyond Telegram's API (api.telegram.org) and no other surprising privileges. If you need higher assurance, run the CLI in a sandboxed environment and verify the config file contents and permissions after saving credentials.
Capability Analysis
Type: OpenClaw Skill
Name: tsend
Version: 2.1.0
The OpenClaw skill 'tsend' is a legitimate tool designed to send files and messages via Telegram. The code exclusively interacts with the official Telegram Bot API (api.telegram.org) and stores configuration (bot token, chat ID) locally in `~/.tsend/config.json` or reads from environment variables. There is no evidence of intentional malicious behavior such as unauthorized data exfiltration, credential theft, persistence mechanisms, or attempts to compromise the system. The `SKILL.md` instructions are clear, transparent, and do not contain any prompt injection attempts or hidden commands designed to mislead the AI agent or user into performing harmful actions. The ability to send arbitrary files is inherent to a file-sending tool and requires explicit user instruction or agent action.
Capability Assessment
Purpose & Capability
The name/description (send files via Telegram) match the bundled Python CLI and client code. The code uses the Telegram Bot API (api.telegram.org) and httpx to upload files. One minor mismatch: registry metadata lists no required env vars or config paths, but the implementation uses TSEND_TOKEN, TSEND_CHAT_ID, TSEND_PROFILE and persists config to ~/.tsend/config.json — reasonable for this purpose but not declared in the metadata.
Instruction Scope
SKILL.md contains explicit install and usage instructions for the tsend CLI and only references sending files/messages via Telegram. The runtime instructions do not direct the agent to read unrelated files, system credentials, or contact endpoints other than Telegram API. It does instruct saving tokens/chat IDs to ~/.tsend/config.json, which is necessary for the tool and consistent with the CLI behavior.
Install Mechanism
There is no automated install spec in the registry; SKILL.md recommends installing locally via the 'uv' tool or pip install -e . These are standard developer installs. The project dependencies (httpx, typer) are reasonable for an HTTP CLI. No downloads from unknown URLs or archive extraction are present.
Credentials
The code reads TSEND_TOKEN, TSEND_CHAT_ID and TSEND_PROFILE environment variables and otherwise stores tokens/chat IDs in ~/.tsend/config.json. These are the minimal secrets required to operate and are proportional to the tool's purpose. The registry metadata did not declare these env vars, which is an omission to be aware of.
Persistence & Privilege
The skill does create and write its own config at ~/.tsend/config.json (user home), which is expected for a CLI that stores credentials. It does not request permanent platform-wide presence (always: false) and does not modify other skills or system-wide agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tsend - After installation, invoke the skill by name or use
/tsend - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.1.0
# tsend v2.1.0 Release Notes
## New Features
- **Multi-file support**: Send multiple files in one command
```bash
tsend send file1.pdf file2.jpg file3.png
tsend send *.pdf
```
- **Progress indicator**: Shows `[1/3]` style progress for batch uploads
- **Batch statistics**: Displays total file count and combined size
- **Smart caption handling**: Caption is sent with the first file only
## Examples
```bash
# Send multiple files
tsend send document.pdf photo.jpg notes.txt
# Wildcard support
tsend send ~/Downloads/*.zip --caption "Backup files"
# Mixed arguments
tsend send report.pdf chart.png data.csv
```
## Notes
- Files are sent sequentially to avoid rate limits
- If one file fails, others continue uploading
- Exit code 1 only if all files fail
v1.0.0
Initial release of the tsend skill.
- Allows users to send files via Telegram using a simple CLI command.
- Supports sending documents or images with optional captions.
- Enables quick profile switching for multiple bots.
- Provides easy configuration management and troubleshooting.
Metadata
Frequently Asked Questions
What is telegram send files?
Send files quickly via Telegram using the tsend CLI tool with optional captions, profiles, and simple token/chat ID configuration. It is an AI Agent Skill for Claude Code / OpenClaw, with 642 downloads so far.
How do I install telegram send files?
Run "/install tsend" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is telegram send files free?
Yes, telegram send files is completely free (open-source). You can download, install and use it at no cost.
Which platforms does telegram send files support?
telegram send files is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created telegram send files?
It is built and maintained by Shingwha (@shingwha); the current version is v2.1.0.
More Skills