SuperAPI AI 工具集

telegram-cli

通用与其它

查看项目

更新于 10-16 08:03

技能介绍

用途:通过本地 MTProto/Telethon 脚本操作用户个人 Telegram 账号,读取和搜索聊天;Telegram Bot API 无法读取个人账号内容。

主要能力:列出会话(dialogs,--query 按名称、用户名、标题做分词匹配)、读取最近消息(messages)、搜索消息(search,可用 --chat 限定单个会话)、列出未读会话(unread-dialogs,默认排除静音和归档,可用 --include-muted/--include-archived)、列出未读私聊(unread-dms);写操作包括发送消息(send)、标记已读(mark-read)、归档/取消归档(archive/--unarchive)、静音/取消静音(mute/--unmute)。

使用方式:先认证一次,运行 <skill-path>/scripts/setup-api-key.sh 和 <skill-path>/scripts/telegram-cli auth;查看帮助用 <skill-path>/scripts/telegram-cli help。写命令默认 dry-run,需用户明确批准具体动作或批次后才加 --execute。发送前应先给出草稿并确认最终收件人和文本。输出为 JSON,应解析 JSON 而非抓取文本。

限制与安全:非认证 CLI 操作有 60 秒超时,超时的 --execute 写操作结果未知,重试前需在 Telegram 中核实。Telethon 会话等同高权限密钥。未读保持为尽力而为,需在真实聊天中验证。除非用户明确要求,不要添加编辑/删除/批量导出/后台自动化。发送消息、启用后台监听、批量导出大量历史、更改密钥或会话存储方式前应先停下询问。配置存于 ~/.config/telegram-cli/config.json 或系统加密凭据,.env 仅为可选回退。MCP 兼容代码保留给既有使用者,普通任务应使用 CLI。