← Back to Skills Marketplace
247
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install telegram-file-sender
Description
Send files or notes up to 50MB to a Telegram user via bot, supporting local, iCloud, relative, or Knowledge/ paths with automatic zipping if needed.
Usage Guidance
This skill appears to do what it says, but review these practical points before installing or using it:
- Ensure you trust the agent with local files: the script will read any file path you provide and prepare it for sending (no built-in checks prevent sending sensitive files).
- Check which bot account will be used: the script defaults to 'CyreneAssistant_bot' if you don't pass accountId. Confirm OpenClaw's configured accountId(s) before sending.
- The SKILL.md mentions '~' expansion and workspace isolation, but the included script does not expand '~' nor enforce workspace boundaries; the agent or caller should expand user paths and enforce directory restrictions if needed.
- Confirm python3 is available on the runtime host since the instructions call 'python3' (the metadata did not declare python3 as required).
- Temporary files are removed on the normal success path, but if the message tool fails or the agent crashes, tmp files may remain — monitor and clean /tmp as needed.
- If you need stricter controls (prevent sending files outside a specific workspace or blocking certain extensions), request those checks be added to the helper or enforced by platform policies.
Capability Assessment
Purpose & Capability
Name/description match the included helper script and runtime instructions. The skill prepares a local file (optionally zips it) and relies on OpenClaw's message/send tool to actually call the Telegram API — this is coherent for a 'Telegram File Sender'. No unrelated credentials, binaries, or external endpoints are requested by the skill.
Instruction Scope
Instructions are narrowly scoped: run the bundled Python helper to prepare a file, parse its output, call the platform's message tool to send the file, then delete temp files. However, two minor mismatches should be noted: (1) SKILL.md mentions support for '~' and iCloud paths and 'workspace isolation', but the script does not call os.path.expanduser() or perform explicit workspace-restriction checks; it will accept any path that exists on disk. (2) The script can read and copy any file the agent is asked to send — this is expected behavior but means the agent (and the user) must ensure they don't inadvertently send sensitive local files.
Install Mechanism
This is an instruction-only skill with a small helper script included (no install spec). That is low risk. The SKILL.md invokes 'python3' but the registry metadata did not declare python3 as a required binary; platforms that lack python3 would fail. No network downloads or archive extraction are performed.
Credentials
The skill declares no environment variables or secrets. It relies on OpenClaw's server-side Telegram bot configuration (accountId) which is appropriate. The script has a hardcoded default account_id ('CyreneAssistant_bot') if none is provided — users should verify that default or pass the intended accountId.
Persistence & Privilege
The skill does not request permanent presence (always:false), does not modify other skills or system-wide configuration, and does not require elevated privileges. It creates temporary files under a temp directory and instructs the agent to delete them after sending.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install telegram-file-sender - After installation, invoke the skill by name or use
/telegram-file-sender - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
1.0.3: Simplified file identification — any path/extension works, no Knowledge/ requirement.
v1.0.2
1.0.2: Removed all personal bot names and user IDs from skill content. All examples now use generic placeholders.
v1.0.1
1.0.1: Expanded SKILL.md body content, replaced subprocess zip with native zipfile module, added homepage metadata, resolved preflight warnings.
v1.0.0
Initial release: send files/documents to Telegram users via bot. Handles files up to 50MB, auto-zips larger files, supports iCloud and local paths.
Metadata
Frequently Asked Questions
What is Telegram File Sender?
Send files or notes up to 50MB to a Telegram user via bot, supporting local, iCloud, relative, or Knowledge/ paths with automatic zipping if needed. It is an AI Agent Skill for Claude Code / OpenClaw, with 247 downloads so far.
How do I install Telegram File Sender?
Run "/install telegram-file-sender" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Telegram File Sender free?
Yes, Telegram File Sender is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Telegram File Sender support?
Telegram File Sender is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Telegram File Sender?
It is built and maintained by wuu Dao (@daowuu); the current version is v1.0.3.
More Skills