A specialized Openclaw Skills implementation to operate the Telegram Bot API through uxc using path-based authentication and OpenAPI schemas.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install telegram-openapi-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install telegram-openapi-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Telegram Bot API Skill?
This Openclaw Skills module enables seamless interaction with the Telegram Bot API via the uxc command-line utility. It leverages a curated OpenAPI schema to provide a structured way to manage bot identities, send text or media, and handle updates through either polling or webhooks. By using these Openclaw Skills, developers can integrate Telegram functionality into their local development environments and automated agents with minimal configuration overhead.
The core value of this skill lies in its ability to handle Telegram's unique authentication requirements—specifically the bot token embedded in the URL path—using a secure path-prefix template. This ensures that sensitive credentials are never exposed in logs or command history while maintaining compatibility with the full range of supported Telegram operations.
Telegram Bot API Skill Use Cases
- Automating bot identity checks and chat metadata lookups using Openclaw Skills.
- Sending notifications and media reports from CI/CD pipelines directly to Telegram chats.
- Implementing persistent message listeners through daemon-backed polling subscriptions.
- Managing bot webhook configurations across multiple environments.
- Processing multipart file uploads for automated document sharing via Telegram.
How Telegram Bot API Skill Works
- Configure the Telegram bot token as a secure environment variable for use within Openclaw Skills.
- Apply a path-prefix authentication template to map the token to the api.telegram.org endpoint.
- Link the curated OpenAPI schema to create a dedicated CLI tool for Telegram operations.
- Execute API calls using structured JSON or key-value arguments for messaging and management.
- Utilize the uxc subscribe command to establish a polling daemon that captures and sinks updates in NDJSON format.
Telegram Bot API Skill Setup
To begin using these Openclaw Skills, ensure uxc is installed and follow these steps:
# Configure the credential
uxc auth credential set telegram-bot \
--auth-type api_key \
--secret-env TELEGRAM_BOT_TOKEN \
--path-prefix-template "/bot{{secret}}"
# Create the binding
uxc auth binding add \
--id telegram-bot \
--host api.telegram.org \
--scheme https \
--credential telegram-bot \
--priority 100
# Link the specialized CLI
uxc link telegram-openapi-cli https://api.telegram.org --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/telegram-openapi-skill/references/telegram-bot.openapi.json
Telegram Bot API Skill Data Schema & Taxonomy
Openclaw Skills organize Telegram data according to the following schema:
| Data Type | Implementation Detail |
|---|---|
| Authentication | Path-prefix template: /bot{{secret}}/METHOD_NAME |
| Message Payloads | Key-value pairs or positional JSON strings |
| Media Handling | Supports file_id, HTTP URLs, or multipart/form-data for local files |
| Update Sinks | NDJSON (Newline Delimited JSON) for polling outputs |
| Schemas | Curated OpenAPI v3 specification |
Telegram Bot API Skill Advanced Features
- Daemon-backed polling mode with automated item-derived offset progression.
- Support for local multipart file uploads within sendPhoto and sendDocument operations.
- Built-in conflict detection to prevent concurrent polling on a single bot token.
- Secure checkpointing strategy for persistent update subscriptions in Openclaw Skills.
- Flexible webhook management including certificate upload for self-signed SSL configurations.
SKILL.md
Loading
Related Openclaw Skills
EverMemory
EverMemory is a deterministic memory plugin that provides AI agents with persistent context, user profiling, and transparent governance.
Contract Review Agent
An AI-powered legal assistant that automates contract clause analysis, obligation extraction, and renewal tracking for business agreements.
Open-C3 Flow List
A high-performance skill for retrieving and visualizing all CI/CD flows from the Open-C3 platform via API.
Cms
A local, zero-credential reference tool providing instant CMS documentation and best practices for AI agents.
Wine Cellar
A professional-grade wine management system for tracking collections, scanning barcodes, and receiving intelligent pairing advice.
WeChat Article Fetcher
A high-performance utility for extracting full text and metadata from WeChat Official Account (MP) articles.
Featured*
