telegram-ops

name	telegram-ops
description	Telegram Bot API operations for forum management. Use for creating/editing/archiving forum topics, setting topic icons, managing Telegram groups via Bot API. Use when archiving channels/topics. Requires bot token from OpenClaw config.

Telegram Ops

Manage Telegram forum topics and Bot API operations.

Prerequisites

• Bot must be admin in the group with can_manage_topics permission
• Get the bot token from OpenClaw config:

  gateway action=config.get | jq -r '.result.parsed.channels.telegram.botToken'
  

Creating a Topic

When creating a topic, follow all of these steps:

1. Create the topic via Telegram Bot API (returns message_thread_id)
2. Set the icon -- pick one that matches the topic's purpose (see Icon Reference)
3. Choose relevant skills -- run openclaw skills list, pick only ready skills that fit the topic's purpose
4. Write a system prompt -- give the agent context for what this topic is about
5. Patch the OpenClaw config -- register the topic with its skills and system prompt

Step 1: Create via Bot API

curl -X POST "https://api.telegram.org/bot<TOKEN>/createForumTopic" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": <GROUP_ID>,
    "name": "topic name"
  }'

Returns message_thread_id (the topic ID) -- you need this for all subsequent steps.

Step 2: Set the Icon