← Back to Skills Marketplace
163
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install telegram-send-file
Description
Send local files, URLs, or reusable Telegram file_ids into a Telegram chat via Bot API. Use when the task is to deliver a file to Telegram, especially from i...
Usage Guidance
Before installing or running this skill, note the following:
- The script requires a Telegram bot token (TELEGRAM_BOT_TOKEN) but the registry metadata does not declare this. Provide a bot token only if you understand the risk: the token grants the skill the ability to post messages and upload files as that bot.
- The script will try multiple token and config file locations in your home directory (e.g., ~/.telegram_bot_token, ~/.config/telegram-send-file/config, ~/.openclaw/openclaw.json) and will read ~/.openclaw/session-state.json for auto-detection of chat/topic. If those files contain sensitive data you do not want exposed to the bot, remove or relocate them before use.
- The skill can upload arbitrary local files and URLs. Do not run it on a machine or as a user that has access to files you would not want sent to the target Telegram chat. Consider creating a dedicated, limited user account or container for running the script.
- The included script appears truncated/buggy at the end (a call to get_toke instead of get_token and the file appears cut off). That suggests the packaged code may be incomplete or broken—inspect and fix the code locally before use.
Recommended mitigations:
- Only use a bot token with minimal privileges and ideally one dedicated to this automation (avoid using tokens that control other critical bots).
- Move or sanitize any OpenClaw config/session files that contain unrelated secrets, or run the script in an environment without those files if you don't want automatic discovery.
- Review the script source in full (and fix the truncation/bug) before running. If you expect the skill to be trustworthy, ask the author/registry to update the package metadata to declare TELEGRAM_BOT_TOKEN and the config paths the script reads.
Capability Assessment
Purpose & Capability
The name, README, SKILL.md, and script all describe the same capability: uploading local files, URLs, or Telegram file_ids to a Telegram chat via a bot. That behavior is consistent with the stated purpose.
Instruction Scope
SKILL.md and the README instruct use of the included python script. The script will (a) read a bot token from environment or several config file locations in the user's home directory (including ~/.telegram_bot_token and ~/.openclaw/openclaw.json), (b) read ~/.openclaw/session-state.json for auto-detection of chat/topic, and (c) open arbitrary local files supplied to upload them. Those file reads are within the declared functional scope, but SKILL.md/registry do not declare the config files and env vars the code will access, and reading session/openclaw files can expose other local state. The script also supports sending arbitrary local files/URLs which is a natural capability but can be used to exfiltrate sensitive files if misused.
Install Mechanism
There is no install spec in the registry (instruction-only skill with a bundled script). The README recommends installing python-telegram-bot via pip, which is typical. No external or obscure download URLs are used. This is low-install risk, but the dependency must be installed prior to use.
Credentials
Registry metadata lists no required env vars or primary credential, but the code clearly expects TELEGRAM_BOT_TOKEN (and honors TELEGRAM_DEFAULT_CHAT_ID / TELEGRAM_DEFAULT_TOPIC_ID). It also checks multiple token file locations and reads ~/.openclaw/openclaw.json and ~/.openclaw/session-state.json. The skill therefore requests access to secrets/config that were not declared in the registry manifest—this is a proportionality mismatch and an important transparency/privacy issue.
Persistence & Privilege
The skill is not always-enabled and does not request persistent platform privileges. It does not modify other skills or global system settings. Autonomous invocation is allowed (platform default) but is not combined with other high-privilege flags.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install telegram-send-file - After installation, invoke the skill by name or use
/telegram-send-file - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial public release after workflow refactor, structure cleanup, and package validation.
Metadata
Frequently Asked Questions
What is Telegram Send File?
Send local files, URLs, or reusable Telegram file_ids into a Telegram chat via Bot API. Use when the task is to deliver a file to Telegram, especially from i... It is an AI Agent Skill for Claude Code / OpenClaw, with 163 downloads so far.
How do I install Telegram Send File?
Run "/install telegram-send-file" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Telegram Send File free?
Yes, Telegram Send File is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Telegram Send File support?
Telegram Send File is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Telegram Send File?
It is built and maintained by Lu Wang (@wangwllu); the current version is v0.1.0.
More Skills