telegram-cli
为AI智能体提供结构化的Telegram用户账户操作CLI
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：telegram-cli。 它的用途是：为AI智能体提供结构化的Telegram用户账户操作CLI 详细介绍见：https://321skill.com/skills/telegram-cli/ 请根据该页面的说明完成安装。
使用示例
“用clitg查看我未读的私信，并总结主要内容。”，它会执行相应命令，解析返回的JSON，并为您生成一份清晰的摘要。或者，
对AI说：“在‘项目讨论组’里发送今天的进度更新，并附上这个截图。”，AI会调用clitg完成消息和媒体的发送。
介绍
clitg 是一个专为AI智能体设计的Telegram命令行客户端，它解决了智能体难以与真实Telegram用户账户进行确定性交互的问题。通过提供结构化的JSON/JSONL接口，它让AI能够像人类一样读取收件箱、搜索对话、发送消息、管理群组和频道，并利用Telegram的各类功能。
使用上，您需要先通过uv工具安装clitg，然后配置Telegram应用ID和API哈希。之后，AI智能体（如Claude Code、Cursor等）就可以通过执行命令并解析JSON输出来操作您的Telegram账户。它支持超过150条专为智能体优化的命令，覆盖广泛的Telegram API。
这个工具非常适合需要自动化处理Telegram消息、进行社媒运营、搭建客服机器人或进行个人知识管理的智能体开发者、全栈开发者和内容创作者。它让AI能够安全、可控地接入真实的社交平台。
需要注意的是，clitg直接操作您的真实Telegram账户，权限极高。务必妥善保管生成的session文件，切勿上传或分享。建议在沙箱环境或专用账户中先行测试，并充分利用其提供的预览、确认等安全机制。
核心特点
与常见的Bot API包装库不同，clitg直接对接MTProto协议，提供对真实用户账户的完整控制；其所有交互都通过严格的JSON合约进行，专为AI智能体的结构化输出和输入而设计，避免了传统CLI工具对自然语言提示的依赖。
注意事项
不适合对Telegram API调用实时性要求极高或需要复杂图形界面交互的场景。
常见问题
clitg和Telegram Bot API有什么区别？
clitg操作的是真实的用户账户，拥有更完整的权限和功能（如访问收件箱、使用商业功能），而Bot API是受限的机器人账户。
如何保证我的Telegram账户安全？
clitg提供了干运行预览、精确的操作确认、一次性令牌等多种安全机制，但最重要的是永远不要泄露生成的.session文件。