A specialized AI agent skill for reliable Telegram Web interaction using robust state checks and proof-aware workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install surfagent-telegram-web
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 surfagent-telegram-web 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 Web Skill?
The Telegram Web skill provides an optimized interface for AI agents to interact with the Telegram Web platform effectively. Unlike generic browser tools that often fail on Telegram's complex dynamic UI and contenteditable fields, this Openclaw Skills module uses a dedicated adapter to handle intricate state management. It enables precise control over chat sidebars, message extraction, and composer flows while ensuring high verification standards for every action taken within the browser.
By prioritizing Telegram-native verbs over improvised DOM manipulation, this skill ensures that agents can navigate route changes and app shells without breaking. It is an essential component of the Openclaw Skills ecosystem for any developer building automated communication workflows that require a high degree of reliability and proof of delivery.
Telegram Web Skill Use Cases
- Automated chat and sidebar state monitoring to track conversation flow
- Extracting visible messages from specific conversations for data analysis or response generation
- Managing composer state and draft filling to ensure message accuracy
- Executing proof-aware send flows that verify message delivery through UI changes
- Deciding between specialized adapter tools and raw browser control for optimal performance
How Telegram Web Skill Works
- Confirm the Telegram Web environment state using dedicated health check tools.
- Navigate to or verify that the correct chat conversation is currently open.
- Inspect the current composer state or extract visible messages to understand context.
- Populate the composer draft with the intended target content.
- Verify that the text is correctly present in the draft before triggering the send command.
- Execute the send action and monitor the UI for material changes in the composer.
- Confirm success by verifying the message appears in the visible chat history.
Telegram Web Skill Setup
To integrate this module into your agent, ensure the core browser-operations skill is available and the Telegram Web adapter is configured within your Openclaw Skills environment.
# Example of adding the skill to your agent environment
openclaw install telegram-web
Configure the adapter credentials or session within your environment variables to allow the agent to access the web instance securely. Ensure your agent is instructed to prefer the tgweb_ prefixed tools over generic browser actions.
Telegram Web Skill Data Schema & Taxonomy
The skill organizes data through specialized verbs and state objects to ensure efficiency within Openclaw Skills.
| Tool | Function | Data Returned |
|---|---|---|
| tgweb_get_state | State Monitoring | Current chat ID, composer focus status, and sidebar visibility |
| tgweb_extract_chats | List Management | Array of visible chat objects including titles and metadata |
| tgweb_extract_visible_messages | Message Extraction | History of messages including text content, timestamps, and sender info |
| tgweb_get_composer_state | Input Validation | Content of the current draft and whether the send button is actionable |
Telegram Web Skill Advanced Features
- Proof-aware send flows that require visible UI confirmation before claiming success
- Token-efficient state checks designed to avoid massive DOM dumps and reduce costs
- Specialized support for contenteditable composer behavior inherent to Telegram Web
- Automated blocker identification for modals, onboarding overlays, or login mismatches
- Multi-agent compatibility when used alongside standard browser-operations for hybrid UI probing
SKILL.md
Loading
Related Openclaw Skills
Boutique Design Hotel Search
A specialized AI agent skill for discovering and booking design-forward boutique hotels with real-time data from Fliggy.
Luxury Trip Designer
An AI agent skill powered by flyai CLI to design and book high-end, 5-star travel experiences with real-time data.
Meeting Ops Router
An AI-driven router that transforms meeting transcripts and notes into structured, executable tasks across multiple enterprise platforms.
Discord Skill for AI Agents
A robust Discord operating skill for AI agents that prioritizes route-aware state detection and extraction-first workflows over brittle selector-based automation.
SurfAgent MCP Selection
A strategic routing guide for Openclaw Skills that determines the most efficient automation layer for browser-based tasks.
Quick Getaway: 3-Day Trip Planner
A professional travel orchestration skill that automates 3-day itinerary planning, flight searching, and hotel booking through real-time CLI data.
Featured*
