telegram-topic-setup

Install

Copy to agents/<orchestrator>/skills/telegram-topic-setup/SKILL.md. Requires a Telegram supergroup with forum mode enabled and bot admin permissions.

Telegram Topic Setup Skill

Topic Creation

Use the topic-create action to create a new forum topic:

action: topic-create
channel: telegram
target: telegram:<chatId>
name: <topic-name>
icon_custom_emoji_id: <emoji-id>

Returns a topicId on success.

Initial Message

After creating a topic, send a first message immediately using:

threadId: <topicId>

Telegram may not display the topic in the list until the first message is posted.

Icon Selection

Only custom emoji IDs from Telegram's forum topic sticker set are valid as icon_custom_emoji_id. There are 38 valid IDs. Common ones:

If an invalid ID is used, Telegram ignores it and assigns a default icon.

Recording Topic IDs

Capture every returned topicId and record it in SUPERGROUP-MAP.md under the corresponding team and agent entry. This mapping drives config generation and agent routing.

Binding Agents

Wire each topic to an agent in openclaw.json:

{
  "topics": {
    "<TOPIC_ID>": {
      "requireMention": true,
      "enabled": true
    }
  }
}

Rules:

• Multi-agent topics: all bots must have requireMention: true
• Single-agent topics: the sole agent can use requireMention: false
• Orchestrator: set enabled: false on topics owned by other agents