用途：Telegram CLI 用于在命令行中读取、搜索和发送 Telegram 消息，管理群组与联系人，以及导出聊天历史。适合需要批量处理会话、归档聊天或让 AI 智能体操作 Telegram 的场景。
主要能力：读取收件箱、聊天列表与指定会话消息；按关键词在单个聊天或全局搜索；发送私信、群消息与回复；查看联系人、群成员与管理员；踢人、提升管理员、转移群所有权；静音/取消静音；管理文件夹；同步或导出聊天历史。多数命令支持默认、--json、--markdown 三种输出，媒体消息会显示类型、文件名与大小等元数据。
使用方式：安装命令为 npm install -g @skillhq/telegram。首次使用需在 https://my.telegram.org/apps 获取 API 凭据，然后运行 telegram auth 登录，可用 telegram check、telegram whoami 验证会话。常用命令如 telegram inbox、telegram read "ChatName" -n 50、telegram search "query" --all、telegram send @username "message"、telegram sync --all --chat "Name"。聊天名支持部分匹配，用户名需以 @ 开头，也可用数字 ID；时间参数支持 1h、30m、7d 等格式。
适用场景：检查未读消息、检索话题、回复消息、管理群组成员与权限、归档或增量同步聊天记录。
限制：写操作（发送、回复、踢人、提升、转移所有权）应先经用户确认；transfer-owner 不可逆且需交互输入 2FA 密码，不能无人值守执行。Telegram API 有速率限制，应避免频繁连续调用；大型群组建议用 -n 限制成员输出。转移所有权仅支持超级群组和频道，且受新登录约 24 小时、修改 2FA 密码约 7 天的限制。其余未在资料中说明的功能、收费或平台信息暂未提供。