telegram-ops

✈️ Telegram 论坛自动化运维专家

基于 Telegram Bot API 的论坛主题管理工具,支持创建、归档、图标设置与会话隔离,适合需要结构化群聊管理的运营团队。

收藏
1.9k
安装
630
版本
v1.0.0
CLS 安全性认证2026-05-20
点击查看完整报告 >

使用说明

核心用法

Telegram Ops 是一套面向 Telegram 论坛(Forum)功能的自动化管理技能,主要解决群组话题(Topic)的生命周期管理问题。用户可通过该技能完成:创建新主题并设置自定义图标、为不同主题配置独立的系统提示词(system prompt)与技能集、归档历史主题(重命名、更换图标、关闭话题),以及清理对应的 OpenClaw 会话数据。

操作流程遵循"创建→配置→归档"的完整闭环:首先调用 Telegram Bot API 的 createForumTopic 获取 message_thread_id,随后通过 editForumTopic 设置图标,接着在 OpenClaw 配置中注册该主题的专属会话与提示词,最后通过归档脚本完成话题的关闭与会话导出。

显著优点

1. 会话隔离机制:每个主题拥有独立的 OpenClaw 会话键(agent:main:telegram:group:<GROUP_ID>:topic:<TOPIC_ID>>),确保不同话题间的上下文、历史记录和压缩策略完全隔离,避免信息串扰。

2. 配置继承与覆盖:主题配置继承自父群组,仅需声明差异化覆盖项,大幅降低多主题管理的配置冗余。

3. 可视化图标体系:内置 10 种常用场景图标(⚡💡📰🔥等)及完整 ID 映射表,支持通过 getForumTopicIconStickers 动态获取全量图标。

4. 归档工作流自动化:提供一键归档脚本,自动完成重命名前缀、图标更换、话题关闭及会话导出,符合合规审计要求。

潜在缺点与局限性

  • API 能力缺口:Telegram Bot API 未提供 getForumTopicInfo 方法,无法通过 thread ID 反向查询主题名称,需依赖本地缓存或事件监听维护映射关系。
  • 输入验证薄弱:脚本中 topic_name 等参数直接拼接到 JSON 字符串,特殊字符(如引号、换行)可能导致 API 调用失败。
  • Token 管理依赖外部:bot token 需从 OpenClaw 配置中获取,技能本身不提供 Token 轮换或过期检测机制。
  • 会话清理半自动化:归档后需手动删除 sessions.json 中的条目及转录文件,存在误删或遗漏风险。

适合的目标群体

  • 运营 500+ 成员 Telegram 社区的管理员
  • 需要按项目/话题隔离 AI 对话上下文的团队
  • 追求论坛化信息架构替代传统群聊的社群组织者
  • 已将 OpenClaw 作为中枢 AI 平台的重度用户

使用风险

  • 配置漂移风险config.patch 操作直接修改运行时配置,错误的 JSON 结构可能导致整个 Telegram 通道配置损坏。
  • API 限流与稳定性:Telegram Bot API 存在每分钟 30 条消息的全局限制,批量操作可能触发限流。
  • Token 泄露隐患:curl 命令中的 token 可能通过 shell 历史、进程列表或日志文件泄露。
  • 归档不可逆性closeForumTopic 后话题无法重新打开,需确认备份完成后再执行。

安全解读

核心用法

telegram-ops 是一套用于管理 Telegram 论坛(Forum)主题的运维工具集,主要面向需要通过 Bot API 自动化管理群组讨论区的场景。核心功能包括:

1. 主题生命周期管理

  • 创建新主题 (createForumTopic),返回 message_thread_id 作为唯一标识
  • 编辑主题属性 (editForumTopic),支持修改名称和自定义 emoji 图标
  • 归档主题 (closeForumTopic),通过重命名加 [ARCHIVED] 前缀、设置文件夹图标、关闭主题实现

2. OpenClaw 集成

  • 每个主题对应独立会话:agent:main:telegram:group:<GROUP_ID>:topic:<TOPIC_ID>
  • 支持配置主题专属 system prompt 和技能白名单
  • 归档时导出会话历史并清理配置

3. 图标管理

  • 提供 10+ 种预设 emoji 图标映射(⚡💡📰🔥❤️📝🤖💬📊🎯)
  • 支持调用 getForumTopicIconStickers 获取完整图标列表

显著优点

  • 官方 API 原生调用:直接对接 Telegram Bot API,无中间层,行为可预期
  • 会话隔离设计:每个主题独立会话上下文,避免 conversation history 交叉污染
  • 最小权限原则:Bot Token 从 OpenClaw 配置动态获取,无硬编码凭证
  • 零第三方依赖:仅依赖系统工具 curl 和 jq,无供应链攻击风险
  • 归档工作流完整:提供脚本化归档方案,包含会话导出和配置清理

潜在缺点与局限性

  • 无查询 API:Telegram 未提供 getForumTopicInfo,无法通过 thread ID 反查主题信息,需本地缓存
  • 输入验证薄弱:依赖 Telegram API 返回错误,本地缺乏 chat_id 格式预校验
  • 错误处理简单:仅输出 API 原始错误,无分类重试机制
  • 功能单一:仅限论坛主题管理,不支持消息收发、成员管理等常规 Bot 功能
  • 硬编码 emoji ID:图标 ID 可能随 Telegram 更新而失效,需定期维护

适合人群

  • 运营大型 Telegram 社群的管理员,需将讨论按主题分类归档
  • 使用 OpenClaw 框架搭建多代理系统的开发者
  • 需要将 AI 代理会话与 Telegram 论坛主题绑定的自动化场景

常规风险

  • Token 泄露风险:若 OpenClaw 配置权限不当,Bot Token 可能被其他进程读取
  • 误操作不可逆:删除主题配置或关闭主题后,历史消息虽保留但无法重新激活原主题 ID
  • API 限流:Telegram Bot API 有调用频率限制,批量操作可能触发限制
  • 依赖系统工具:curl/jq 版本差异可能导致脚本兼容性问题

telegram-ops 内容

references文件夹
scripts文件夹
手动下载zip · 7.3 kB
emoji-ids.mdtext/markdown
请选择文件