← Back to Skills Marketplace
8597
Downloads
9
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install telegram-api
Description
Telegram Bot API integration with managed authentication. Send messages, manage chats, handle updates, and interact with users through your Telegram bot. Use this skill when users want to send messages, create polls, manage bot commands, or interact with Telegram chats. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user.
Usage Guidance
Install this only if you intend to let an agent operate your Telegram bot through Maton. Review each proposed send, edit, delete, webhook, or connection action before approving it, and prefer OAuth over long-lived API keys.
Capability Assessment
Credentials
Network access, Bash, and Maton account authentication are proportionate for a Telegram Bot API integration; the raw HTTP fallback is limited to cases where the CLI cannot be installed.
Install Mechanism
It asks users to install the Maton CLI globally through npm or Homebrew, which is purpose-aligned but should be done only from the intended Maton package/source.
Instruction Scope
The instructions repeatedly require read/list first, explicit user approval for connection creation and all modifying calls, target disambiguation for multiple connections, and treating Telegram content as untrusted data.
Persistence & Privilege
OAuth/API credentials are persistently stored by the Maton CLI in the operating system credential store and renewed as needed; this is disclosed and the skill instructs agents not to inspect, print, export, or persist secrets elsewhere.
Purpose & Capability
The documented capabilities match the stated Telegram Bot API purpose: bot info, updates, chats, messages, media, polls, webhooks, bot commands, and profile updates through Maton.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install telegram-api - After installation, invoke the skill by name or use
/telegram-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.2
Fix the raw HTTP fallback example: restore the gateway base URL in the GATEWAY constant (and the fastmail streaming call), which a previous edit had replaced with a placeholder
v1.2.1
Address security-audit findings: disclose the api passthrough in the access-scope and description text, warn on irreversible connection deletion, add response data-minimization guidance, and correct app-specific auth and request-body notes
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.3
- Changed API base URLs from gateway.maton.ai and ctrl.maton.ai to api.maton.ai throughout all usage examples and documentation.
- Updated the connection management instructions and endpoints to use the new base URL.
- Added a security and permissions section, clarifying resource access and the need for explicit user approval for write operations.
- Improved guidance for handling multiple Telegram connections with the Maton-Connection header.
- Removed the LICENSE.txt file.
v1.0.2
- Added a new `clawdbot` metadata block with an emoji and environment variables required (`MATON_API_KEY`) in SKILL.md.
- No changes to functionality or usage; documentation only.
v1.0.1
- No file changes detected in this release.
- Version number updated to 1.0.1.
- Documentation and skill functionality remain unchanged.
v1.0.0
Major update: rewritten for managed Maton API gateway integration and streamlined usage.
- Replaced in-depth, self-managed guide with direct instructions for using Telegram via the Maton API gateway.
- Added instructions for authentication with a Maton API key and simplified connection management.
- Removed all detailed Telegram workflow/reference documents.
- Included ready-to-use Python code examples for key operations (bot info, send message, manage connections).
- Centralized documentation to SKILL.md for ease of use; external references are no longer needed.
Metadata
Frequently Asked Questions
What is Telegram Bot?
Telegram Bot API integration with managed authentication. Send messages, manage chats, handle updates, and interact with users through your Telegram bot. Use this skill when users want to send messages, create polls, manage bot commands, or interact with Telegram chats. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user. It is an AI Agent Skill for Claude Code / OpenClaw, with 8597 downloads so far.
How do I install Telegram Bot?
Run "/install telegram-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Telegram Bot free?
Yes, Telegram Bot is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Telegram Bot support?
Telegram Bot is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Telegram Bot?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.2.
More Skills