Telegram Auto Topic

📬 一句话自动创建论坛话题

Telegram 论坛群组自动话题创建工具,输入 /topic 即可智能生成话题标题并自动归档消息

收藏
8.1k
安装
3.2k
版本
0.1.8
CLS 安全性认证2026-05-18
点击查看完整报告 >

使用说明

核心用法

Telegram Auto-Topic 是一款为 Telegram 论坛群组(Forum Groups)设计的自动化工具,用户只需在消息开头添加 /topic 指令,系统即可自动创建独立话题并将消息归档。该工具通过 OpenClaw 框架集成,支持智能标题生成(3-7 个词自动摘要)、媒体文件转发、跨话题消息引用等功能。

显著优点

1. 零摩擦工作流程:无需手动创建话题、命名或复制粘贴,大幅降低论坛群组的管理成本
2. AI 驱动标题生成:自动从消息内容提取 3-7 个关键词作为话题标题,省去用户思考成本

3. 完整媒体支持:照片、视频、文档均可通过 /topic 指令转发至新话题

4. 双向交互体验:原消息获得话题链接回执,同时机器人在新话题内自然回应内容

5. 灵活配置:支持免 @提及模式、自定义 Telegram 命令菜单集成

潜在局限

  • 归因限制:引用消息显示为机器人发送(Telegram API 限制),需通过文本标注原始发送者
  • 媒体转发标识:转发媒体会显示 "Forwarded from" 头部,非原生体验
  • 权限依赖严格:机器人需具备群组管理员身份及 "Manage Topics" 权限
  • 平台限定:仅支持启用论坛功能的超级群组,普通群组和私聊无法使用
  • 标题长度上限:受 Telegram 限制,话题名称最长 128 字符

适合人群

  • 运营大型 Telegram 社区的管理员(DAO、开源项目、学习社群)
  • 需要结构化归档讨论内容的团队协作用户
  • 希望降低话题管理门槛、提升信息组织效率的论坛群组运营者

常规风险

  • 权限配置风险:若机器人权限被撤销或降级,功能将中断但用户可能持续尝试使用
  • 标题生成偏差:自动生成的标题可能遗漏关键语境,导致话题检索困难
  • 消息归因混淆:用户可能误以为机器人转述内容为原创,需明确标注来源
  • 配置泄露风险~/.openclaw/openclaw.json 包含群组配置信息,需妥善保管

技术实现

依赖 OpenClaw 框架的 channels.telegram.groups 配置体系,通过 Bash 脚本调用 Telegram Bot API 实现话题创建(createForumTopic)、消息转发(forwardMessage)及引用回复(sendMessage with reply_to_message_id)。脚本返回 JSON 包含 topic_idtitlelink,供下游消息工具组装回复。

安全解读

核心用法

Telegram Auto-Topic 是一款专为 Telegram 论坛群组(Forum Groups)设计的轻量化自动化工具。用户只需在消息开头添加 /topic 指令,即可自动创建新话题,系统会智能从消息内容中提取 3-7 个关键词作为话题标题,无需手动构思。

典型工作流程:
1. 用户在论坛群组发送 /topic 我需要尽快更新护照

2. 系统自动创建话题「护照更新」并引用原消息

3. 机器人回复可点击的话题链接,并在新话题中继续对话

4. 支持文字、图片、视频、文档等多种媒体类型

显著优点

  • 零摩擦体验:无需离开对话界面,一条指令完成话题创建
  • AI 智能标题:自动提炼核心主题,告别「新建话题 1」这类无效命名
  • 无缝衔接:创建话题后机器人立即在新话题中响应,保持对话连贯性
  • 轻量无依赖:仅使用系统标准工具 curl 和 jq,无第三方包引入供应链风险
  • 配置灵活:支持自定义是否需要 @机器人,可添加至 Telegram 命令菜单

潜在缺点与局限性

  • 归因显示限制:引用消息显示为机器人发送,非原生用户身份(Telegram API 限制)
  • 媒体转发标识:转发的媒体带「Forwarded from」头部,视觉体验稍逊
  • 仅限论坛群组:普通群组和私聊无法使用
  • 权限要求严格:机器人需具备管理员身份及「Manage Topics」权限
  • 标题长度限制:Telegram 强制截断 128 字符以上标题
  • 个人开发者维护:非企业级项目,长期维护稳定性存在不确定性

适合人群

  • 社群运营者:管理大型讨论群组,需要快速分流不同主题讨论
  • 项目协作团队:使用 Telegram 作为工作沟通工具,需要结构化话题管理
  • 兴趣社群管理员:游戏、开源项目、学习小组等高频讨论场景
  • 自动化爱好者:已有 OpenClaw 环境,希望扩展 Telegram 自动化能力

常规风险

  • Token 泄露风险:Bot Token 存储于本地配置文件,需确保 ~/.openclaw/openclaw.json 权限为 600
  • 权限过度授予:建议严格遵循最小权限原则,仅保留「Manage Topics」权限
  • 数据跨境传输:Telegram 服务器位于境外,敏感内容需谨慎
  • 依赖工具安全:curl 和 jq 需保持系统更新,防止工具链漏洞

安全评估结论

本 Skill 通过基础安全检测,静态代码分析未发现危险函数或硬编码凭证,网络请求仅限于官方 Telegram API,供应链攻击面极小。综合评分 75/100,定级为 A 级,适合一般场景使用。建议用户自行审查源码,并定期关注上游更新。

Telegram Auto Topic 内容

scripts文件夹
手动下载zip · 4.1 kB
telegram-auto-topic.shtext/x-shellscript
请选择文件