A comprehensive toolkit for automating Telegram forum topic management and group administration through the Bot API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install telegram-ops
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-ops 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 Ops?
Telegram Ops is a specialized utility designed to bridge the gap between Telegram forum structures and the Openclaw Skills ecosystem. It enables developers to programmatically create, configure, and archive forum topics while synchronizing them with specific AI agent behaviors and system prompts.
By leveraging the Telegram Bot API, this skill allows for granular control over topic aesthetics, such as custom emoji icons, and operational lifecycles. This ensures that every discussion thread is properly registered and managed within the broader agent framework, providing isolated conversation histories for different project threads.
Telegram Ops Use Cases
- Programmatically creating new forum topics for specific project discussions within a group.
- Automating the archiving of stagnant topics to keep Telegram groups organized and searchable.
- Dynamically assigning specific AI system prompts and toolsets to different Telegram threads for specialized assistance.
- Synchronizing Telegram forum metadata with Openclaw Skills configuration files to maintain environment consistency.
- Visual categorization of topics using custom Telegram emoji IDs for rapid identification of alerts, news, or documentation.
How Telegram Ops Works
- The bot authenticates using a secure token retrieved from the global Openclaw Skills configuration.
- A new forum topic is initialized via a POST request to the Telegram Bot API, which returns a unique message_thread_id.
- A custom icon is assigned to the topic using specific custom emoji IDs to visually indicate the thread's primary purpose.
- The skill patches the local configuration to register the new topic and define its specific AI personality and system prompt.
- Each topic receives an isolated session key to maintain independent conversation history and context window management.
- For end-of-life topics, an archive workflow renames, locks, and exports the session history to a markdown file for long-term storage.
Telegram Ops Setup
First, ensure your bot is an administrator in the group with the can_manage_topics permission enabled. Retrieve your bot token from the configuration to verify access:
gateway action=config.get | jq -r '.result.parsed.channels.telegram.botToken'
To register a topic with specific system instructions and link it to your Openclaw Skills setup, use the config patch command:
gateway action=config.patch raw='{"channels":{"telegram":{"groups":{"<GROUP_ID>":{"topics":{"<TOPIC_ID>":{"systemPrompt":"Topic-specific instructions"}}}}}}}'
Telegram Ops Data Schema & Taxonomy
The skill manages data across Telegram's API and the Openclaw Skills local storage directory using the following structure:
| Component | Type | Description |
|---|---|---|
| Session Key | String | agent:main:telegram:group:<GID>:topic:<TID> - unique ID for isolated history. |
| Config Path | JSON Object | .channels.telegram.groups[GID].topics[TID] - stores topic-specific overrides. |
| Archives | File (.md) | Stored in ~/.openclaw/agents/main/sessions/archive/ as formatted transcripts. |
| Icon IDs | Numeric String | Unique Telegram identifiers for custom topic emojis (e.g., 5312016608254762256 for Ops). |
Telegram Ops Advanced Features
- Isolated session management ensuring each topic maintains its own context window and compaction logic without cross-pollination.
- Automated archiving scripts that handle renaming, locking, and exporting in a single, repeatable workflow.
- Configuration inheritance where topics automatically pull settings from parent groups unless specific overrides are defined.
- Support for custom icon sticker IDs to visually distinguish between operational alerts, brainstorming sessions, and news threads.
- Skill restriction capabilities that allow developers to limit the tools available to an agent within a specific forum topic for security or focus.
SKILL.md
Loading
Related Openclaw Skills
Research Agent Skill
An advanced research agent for Openclaw Skills that builds living markdown documentation through interactive exploration and deep asynchronous investigation.
Markdown to Google Doc (md-to-gdoc)
A streamlined utility for converting local Markdown documents into professionally formatted Google Docs with preserved styles and hierarchies.
Flights Search
A high-performance flight search tool that retrieves real-time schedules, pricing, and booking links directly from Google Flights.
Domain Check & Buy (Vercel)
A comprehensive toolkit for checking domain availability, pricing, and managing purchases directly via Vercel and Openclaw Skills.
tmux Controller
A powerful skill for managing interactive TTY sessions, allowing AI agents to send keystrokes and scrape terminal output via tmux.
tmux
A specialized skill for remote-controlling tmux sessions to manage interactive CLI tools through keystroke injection and pane scraping.
Featured*
