Telegram通知

技能简介

tg 是一款面向 Telegram 的命令行客户端，支持在终端中完成消息读取、关键词搜索、私信发送、群组管理等操作。

业务背景

运维与开发人员无需切换图形界面，在终端即可完成Telegram日常通讯与信息检索。适合服务器环境、远程SSH会话或自动化脚本场景，批量处理消息通知、群组管理、历史记录查询等任务，提升跨平台协作效率。

落地案例：某技术团队将tg集成至监控告警流程：服务器异常触发后，脚本自动调用tg向值班群发送带关键指标的消息摘要；值班人员通过命令行快速检索近7天同类告警记录，比对历史处置方案，无需登录手机或桌面客户端即可完成初步研判与响应同步。

能做什么

• 查看未读消息摘要与聊天记录
• 按时间范围或数量筛选历史消息
• 跨聊天或全局搜索特定内容
• 向个人或群组发送消息及回复
• 查询联系人资料、群组成员与管理员列表
• 输出 JSON 格式便于脚本集成

使用说明

安装

npm install -g @cyberdrk/tg

或从源码构建：

cd ~/Code/cyberdrk305/telegram && npm install && npm run build && npm link

首次配置

访问 https://my.telegram.org/apps 获取 API ID 和 Hash，然后执行：

tg auth

常用命令

查看收件箱：tg inbox

读取指定聊天最近50条：tg read "ChatName" -n 50

搜索关键词：tg search "query" --all

发送私信：tg send @username "message"

获取群组成员：tg members "GroupName"

JSON 输出：tg inbox --json

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管 API 凭证，避免泄露导致账号风险
• 频繁调用可能触发 Telegram 速率限制
• 部分国家/地区对 Telegram 服务存在访问限制
• 命令行环境无二次确认，发送操作请仔细核对目标对象

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/arein/tg/SKILL.md
来源类型：GitHub 仓库