telegram-ops

核心用法

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 后话题无法重新打开，需确认备份完成后再执行。