Telegram 自动主题

添加/topic到 Telegram 论坛群组中任何消息的开头 → 将以此创建一个新主题。标题会自动从您的消息中提取——无需您自己费心构思。

示例

1.您发送一条以/topic开头的消息：

/topic @your_bot 我需要在三月前研究续签护照的事

2.一个新的论坛主题"三月前续签护照"被创建，其中引用了您的消息。您会收到一个直接链接到新主题的回复。

前提条件

• 该群组必须在 OpenClaw 中配置（channels.telegram.groups.<CHAT_ID>）——这是 OpenClaw 知道处理来自该群组消息的方式。
• 该群组必须已启用论坛/主题功能。
• 您的机器人必须是群组中的管理员，并拥有管理话题权限。

处理 /topic 命令

当消息以/topic开头时：

1. 生成一个简洁的、由 3-7 个单词组成的标题来总结该消息。
2. 运行脚本 —— 用消息上下文中的实际值替换占位符：

   scripts/telegram-auto-topic.sh <chat_id> <message_id> "<sender name>" "<title>" "<text after /topic>"
   

   如果没有文本（例如，只有媒体），则为文本参数传递一个空字符串。 使用相对于此技能目录的路径。
3. 脚本返回包含topic_id、title和link的 JSON。
4. 回复原始消息：话题已创建 → [<标题>](<链接>)
5. 然后在新的主题中发送对实际消息内容的回复（使用消息工具，并传入返回的threadId）。topic_id)。像回复任何消息一样自然地回应。
6. 两条回复都发送后，回复 NO_REPLY。

工作原理

1. 您发送一条以/topic
2. 开头的信息
3. 一个新的论坛主题被创建——标题根据您的信息自动生成
4. 您的信息会在新主题中被引用，并附上您的名字
5. 您会收到一个回复，其中包含指向新主题的可点击链接

机器人在新主题中回复您的信息也适用于媒体——带有/topic

说明的照片、视频或文档会被转发到新主题中。

scripts/telegram-auto-topic.sh <chat_id> <message_id> <sender> [title] [text]

{"topic_id": 123, "title": "使用的标题", "link": "https://t.me/c/..."}可选配置

跳过@bot提及

——默认情况下，机器人仅在提及时响应。要使用/topic/topic不要提及机器人：

"channels.telegram.groups.<CHAT_ID>": {
  "requireMention": false
}

Telegram自动补全— 要在/topic在Telegram的命令菜单中，添加在channels.telegram下：

{
  "customCommands": [
    {
      "command": "topic",
      "description": "Create a new forum topic from a message"
    }
  ]
}

限制

• 归属：引用的消息会显示为机器人发送（Telegram API限制）。发送者名称会作为归属文本包含在引用下方。
• 媒体：转发的媒体会显示“转发自”标题——这是目前最好的方式，但并非原生支持。
• 仅限论坛群组：在普通群组或私信中无法使用。
• 权限：机器人需要拥有“管理话题”权限的管理员身份。
• 标题长度：Telegram限制话题名称最多128个字符。