telegram-bot-cli

Send text, documents, and photos to Telegram chats via the Bot API.

6|1|Updated May 13, 2026
One-click install
npx skills add https://github.com/Xipher-Labs/walter-os --skill telegram-bot-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telegram-bot-cli
Source: https://github.com/Xipher-Labs/walter-os/tree/main/skills/telegram-bot-cli
Command: npx skills add https://github.com/Xipher-Labs/walter-os --skill telegram-bot-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the need to manually copy-and-paste notifications by letting you reliably send text, documents, and photos to Telegram from your scripts or CI pipeline.

Core Features & Use Cases

  • Telegram Bot API messaging: Send chat messages with formatting via sendMessage.
  • File and media notifications: Upload documents with sendDocument and images with sendPhoto (useful for deploy reports and screenshots).
  • Bounded access safety: Uses Bot API scope so the bot only sees chats it was added to (reducing blast radius compared to MTProto user-bots).
  • Operational scenarios: Notify on deployments, uptime incidents, audits, spending thresholds, and long-running task completion.

Quick Start

Create a Telegram bot with BotFather, store your token and chat ID as WALTER_TELEGRAM_BOT_TOKEN and WALTER_TELEGRAM_CHAT_ID, then tell the agent to send the message you want to your configured chat.

Frequently Asked Questions about telegram-bot-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send Telegram notifications from a CI pipeline?

To send Telegram notifications from a CI pipeline, use this Skill to call the Telegram Bot API for text, documents, and photos. It reliably sends alerts to a specific chat without manual copy-and-paste.

What do I need to configure to send a Telegram message via curl?

To send a Telegram message via curl, you must create a bot with BotFather and configure your bot token and chat ID as environment variables. The agent then uses these credentials to send your message.

Can I upload files and photos to Telegram from shell scripts?

Yes, you can upload files and photos to Telegram from shell scripts. The Skill uses the Bot API sendDocument and sendPhoto endpoints to upload documents and images directly to your configured chat.

Is using a Telegram Bot API scope safer than MTProto user-bots?

Using a Telegram Bot API scope is safer than MTProto user-bots because it provides bounded access. The bot only sees chats it was added to, reducing the blast radius compared to broader personal Telegram data access.

What are the best use cases for automated Telegram bot alerts?

The best use cases for automated Telegram bot alerts include CI/deploy completion notifications, monitoring uptime incidents, audit alerts, spending thresholds, and long-running task updates generated from scripts.