✓ Verified 📱 Social Media ✓ Enhanced Data

Tsend

Send files via Telegram.

Rating: 4 (371 reviews)
Downloads: 704 downloads
Version: 1.0.0

Overview

Send files via Telegram.

Complete Documentation

View Source →

Telegram Sender (tsend)

Zero-config CLI tool. Install once, send forever.

Installation

Tip: Try using tsend command first. If command not found, then install.

Using uv (recommended)

bash

cd <skill-path>/scripts
uv tool install -e .

Replace with the actual skill path.

After installation, tsend command is available globally.

From source (alternative)

If you don't have uv:

bash

cd <skill-path>/scripts
pip install -e .

Just use it

bash

tsend send document.pdf
tsend send photo.jpg --caption "Description"
tsend send image.png -c "Screenshot"

# Send multiple files
tsend send file1.pdf file2.jpg file3.png
tsend send *.pdf --caption "Documents"  # caption only goes to first file

Using specific profile

bash

tsend send file.pdf --profile mybot
tsend send photo.png -c "Description" -p picoclaw

That's it. No setup, no checks, no questions.

Only if it fails (once)

bash

tsend config set --token "YOUR_BOT_TOKEN" --chat-id "YOUR_CHAT_ID"

Or specify a profile:

bash

tsend config set --profile mybot --token "TOKEN" --chat-id "CHAT_ID"
tsend config default mybot  # Set as default

The tool saves config to ~/.tsend/config.json.

Multiple Profiles

Manage multiple bots with profiles:

bash

# List all profiles
tsend config list

# Show specific profile
tsend config show --profile mybot

# Send with specific profile
tsend send file.pdf --profile mybot

Environment Variable

Set default profile via environment:

bash

export TSEND_PROFILE=mybot
tsend send file.pdf  # Uses 'mybot' profile

Useful for different services (nanobot, picoclaw, etc.).

When something's wrong

"token invalid" → Fix with one command:

bash

tsend config set --token NEW_TOKEN --chat-id NEW_ID

No reinstall, no config file hunting.

Installation

Terminal bash


openclaw install tsend

Copied!

💻Code Examples

uv tool install -e .

uv-tool-install--e-.txt

Replace `<skill-path>` with the actual skill path.

After installation, `tsend` command is available globally.

### From source (alternative)

If you don't have uv:

tsend send photo.png -c "Description" -p picoclaw

tsend-send-photopng--c-description--p-picoclaw.txt

That's it. No setup, no checks, no questions.

## Only if it fails (once)

tsend config default mybot # Set as default

tsend-config-default-mybot--set-as-default.txt

The tool saves config to `~/.tsend/config.json`.

## Multiple Profiles

Manage multiple bots with profiles:

tsend send file.pdf --profile mybot

tsend-send-filepdf---profile-mybot.txt

## Environment Variable

Set default profile via environment:

tsend send file.pdf # Uses 'mybot' profile

tsend-send-filepdf--uses-mybot-profile.txt

Useful for different services (nanobot, picoclaw, etc.).

## When something's wrong

**"token invalid"** → Fix with one command:

example.sh

tsend send document.pdf
tsend send photo.jpg --caption "Description"
tsend send image.png -c "Screenshot"

# Send multiple files
tsend send file1.pdf file2.jpg file3.png
tsend send *.pdf --caption "Documents"  # caption only goes to first file

example.sh

# List all profiles
tsend config list

# Show specific profile
tsend config show --profile mybot

# Send with specific profile
tsend send file.pdf --profile mybot