A specialized skill for implementing interactive inline keyboards in Telegram to streamline agent-to-human decision-making and confirmations.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install telegram-inline-buttons
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-inline-buttons 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 Inline Buttons?
The Telegram Inline Buttons skill enables AI agents to move beyond simple text prompts and utilize Telegram's native interactive UI. By incorporating inline buttons into workflows, agents can present users with structured choices such as A/B options, confirmation prompts, and scheduling selections. This capability is a core feature for developers building high-efficiency Openclaw Skills that prioritize user experience and minimize the friction of manual text entry.
This skill focuses on making interactions crisp and visually organized. It includes built-in logic for handling user selections, such as automatically editing messages to reflect choices and using emojis to signify status changes. This ensures the chat history remains clean and actionable without unnecessary message clutter.
Telegram Inline Buttons Use Cases
- Requesting binary Yes/No confirmations for critical agent actions.
- Presenting multiple-choice options (A/B/C) for project directions or creative tasks.
- Quick scheduling of reminders using predefined time intervals like 15m, 1h, or Tomorrow.
- Providing "Not now" or "Skip" escape hatches for non-mandatory tasks.
- Approving or rejecting proposed changes in a DevOps or deployment workflow.
How Telegram Inline Buttons Works
- The agent identifies a scenario requiring user input, such as a confirmation or a choice between specific options.
- The skill utilizes the Openclaw Skills message tool to send a text prompt accompanied by a structured grid of inline buttons.
- Once a user clicks a button, the skill captures the specific callback data associated with that selection.
- The agent automatically edits the original Telegram message to remove the inline keyboard, preventing accidental duplicate clicks.
- A visual confirmation line is appended to the message using standard emoji mapping to indicate which option was selected.
- The workflow proceeds to the next logical step based on the user's crisp decision.
Telegram Inline Buttons Setup
To use this skill within your Openclaw Skills environment, ensure your Telegram bot is configured and the message tool is accessible. Use the following pattern in your tool calls:
# Example of sending a message with a 2-button grid
functions.message(
action="send",
text="Should I proceed with the deployment?",
buttons=[["Proceed", "Hold"]]
)
Ensure that your bot has the necessary permissions to edit its own messages to support the automatic UI cleanup feature.
Telegram Inline Buttons Data Schema & Taxonomy
| Element | Technical Description | Implementation |
|---|---|---|
| Button Labels | Short text (1-4 words) for the button surface | String |
| Button Grid | 2D array defining the layout of rows and columns | Array of Arrays |
| Callback Data | Unique string identifier for tracking the selection | String |
| Emoji Mapping | Visual status indicators for post-click edits | ✅ (Proceed), 🟥 (Cancel), ⬛ (Defer) |
| Edit Action | The method used to update existing messages | functions.message(action='edit', ...) |
Telegram Inline Buttons Advanced Features
- Smart Message Editing: Automatically removes buttons after selection to maintain a clean, single-source-of-truth chat history.
- Visual Feedback System: Uses standardized emoji mapping (✅, 🟥, ⬛) to provide immediate visual confirmation of the user's choice.
- Stale Callback Protection: Silently ignores duplicate or late button presses to prevent logic errors in long-running flows.
- Branching Logic Support: Enables complex multi-step decision trees where each button click triggers a subsequent tailored prompt.
- Flexible Layouts: Supports custom grid configurations (1x2, 2x2, 1x3) to optimize the UI for the number of choices provided.
SKILL.md
Loading
Related Openclaw Skills
Self-Improvement Skill
A systematic framework for AI agents to log errors, user corrections, and new insights to enable continuous self-optimization.
Text Detection Skills
A comprehensive suite of forensic tools for identifying AI-generated text through advanced NLP, pattern analysis, and machine learning classification.
Smart Cache
A high-performance caching utility providing intelligent data retention through LRU and LFU eviction strategies.
Rate Limit Pro
A robust rate-limiting utility for managing API quotas and request throttling through customizable user tiers.
Talking Circle AI Video Generator
A specialized tool for Openclaw Skills that converts text or audio into animated circular avatar videos with automated lip-sync and blink cycles.
Bilibili Video Analyzer
An automated tool for converting Bilibili educational content into structured, clean-style study notes with AI-driven insights and visual aids.
Featured*
