name: telegram-topic-rename description: Rename Telegram forum topics and change icons via Bot API. Use when user asks to name/rename a topic, change topic title, update topic icon, or says "命名这个topic", "给话题起个名", "换个图标". Requires TELEGRAM_BOT_TOKEN environment variable.

Telegram Topic Rename / Telegram 话题命名

Rename Telegram forum topics and optionally change their icons.

重命名 Telegram 论坛话题，可选更换图标。

Setup / 配置

Set TELEGRAM_BOT_TOKEN in your environment or OpenClaw config:

在环境变量或 OpenClaw 配置中设置 TELEGRAM_BOT_TOKEN：

export TELEGRAM_BOT_TOKEN="your-bot-token"

Usage / 使用方法

Get topic info / 获取话题信息

Extract from session context:

• chat_id: User ID (private) or group ID
• thread_id: From message_thread_id or session key

从会话上下文提取：

• chat_id：用户 ID（私聊）或群组 ID
• thread_id：从 message_thread_id 或 session key 获取

Run the script / 运行脚本

# Rename only / 仅改名
scripts/rename-topic.sh <chat_id> <thread_id> "新名称"

# Rename + change icon (emoji shortcut) / 改名 + 换图标（emoji 快捷方式）
scripts/rename-topic.sh <chat_id> <thread_id> "新名称" 🤖

# Rename + change icon (full ID) / 改名 + 换图标（完整 ID）
scripts/rename-topic.sh <chat_id> <thread_id> "新名称" 5309832892262654231

# List available icons / 列出可用图标
scripts/rename-topic.sh --icons

Naming rules / 命名规则

• Length / 长度: ≤10 characters / 字符
• Style / 风格: Concise, capture the core theme / 简洁，抓住核心主题
• Auto-icon / 自动选图标: Match icon to topic theme (see references/icons.md)

Icon quick reference / 图标速查

Full list: See references/icons.md

完整列表：见 references/icons.md