Telegram Topic Rename

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 / 图标速查

Theme / 主题	Icon
AI / 机器人	🤖
Code / 编程	💻
Science / 科学	🔬
Work / 工作	💼
Notes / 笔记	📝
Chat / 闲聊	💬
Games / 游戏	🎮
Music / 音乐	🎵
Ideas / 想法	💡
Fire / 热门	🔥

Full list: See references/icons.md

完整列表：见 references/icons.md