Telegram 论坛自动化运维专家

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

基本信息

• 技能名称?telegram-ops
• 中文名称?Telegram 论坛自动化运维专家
• 作者?BrennerSpear
• 分类?效率
• 版本?v1.0.0
• 标签?automation, operations, api, content-media, product-management

使用方法

使用说明
核心用法
Telegram Ops 是一套面向 Telegram 论坛（Forum）功能的自动化管理技能，主要解决群组话题（Topic）的生命周期管理问题。用户可通过该技能完成：创建新主题并设置自定义图标、为不同主题配置独立的系统提示词（system prompt）与技能集、归档历史主题（重命名、更换图标、关闭话题），以及清理对应的 OpenClaw 会话数据。
操作流程遵循"创建→配置→归档"的完整闭环：首先调用 Telegram Bot API 的 createForumTopic 获取 message_thread_id ，随后通过 editForumTopic 设置图标，接着在 OpenClaw 配置中注册该主题的专属会话与提示词，最后通过归档脚本完成话题的关闭与会话导出。
显著优点

1. 会话隔离机制 ：每个主题拥有独立的 OpenClaw 会话键（ agent:main:telegram:group: :topic: > ），确保不同话题间的上下文、历史记录和压缩策略完全隔离，避免信息串扰。
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 后话题无法重新打开，需确认备份完成后再执行。