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.

Audits

Pass

Install

openclaw skills install telegram-topic-rename

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