Tg History

---
name: tg-history
description: Efficiently extract and read Telegram group chat history as text, bypassing screenshots/OCR for zero-token-waste.
metadata:
  {
    "openclaw": {
      "requires": { "plugins": ["browser"] }
    }
  }
---

# tg-history Skill

极速、省钱的 Telegram 聊天记录读取工具。

## 功能
- **直接提取文本**：不通过截图 or OCR，直接从网页 DOM 中抓取聊天记录。
- **Token 暴减**：相比截图，Token 消耗降低 99% 以上。
- **精准格式**：自动整理为 `[时间] 发送者: 消息内容` 的清爽格式。

## 核心机制 (串行执行流程)
为了确保读取的是最新且正确的群聊记录，必须执行以下流程：

1. **精准导航 (Navigate & Wait)**:
   - 搜索并进入目标群组。
   - 等待至少 2 秒，确保 DOM 加载完成。
2. **标题核验 (Verify Title)**:
   - 检查 `.ChatInfo .title` 元素。
   - 确认标题与目标群名完全匹配。严禁在标题未确认的情况下提取数据。
3. **强制触底 (Scroll to Bottom)**:
   - 循环检测并点击“向下箭头” (`.sticky-reveal-button`)，直到其消失。
   - 若箭头未出现，手动将 `.MessageList` 滚动至 `scrollHeight`。
4. **提取与整理 (Extract & Verify)**:
   - 确保看到的是最新的消息（可通过时间戳校验）。
   - 从 DOM 中提取文本，整理为标准格式。

## 使用方法
直接对 AI 说：
- "帮我看看 [群名] 的聊天记录"
- "总结一下 [群名] 最近聊了什么"
- "运行 tg-history 获取 [群名] 历史"

## 优势
传统的“截图+AI识别”方案，一张图就要几千个像素数据；而 `tg-history` 直接读取网页上的文字，一段几百字的聊天记录只占用几百个字节的 Token。