Telegram命令行工具

技能简介

tg 是一款面向 Telegram 的命令行客户端，支持在终端中完成消息读取、关键词搜索、私信发送、群组管理等操作。无需打开图形界面即可快速处理日常通讯需求。

能做什么

• 查看未读消息摘要与聊天记录
• 按时间范围或数量筛选历史消息
• 跨聊天或全局搜索特定内容
• 向个人或群组发送消息及回复
• 查询联系人资料、群组成员与管理员列表
• 输出 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 仓库