tgcli 是面向 AI 智能体的 Telegram CLI 技能，通过命令行操作 Telegram 会话、频道、群组与媒体，并以 JSON 输出便于自动化处理。安装：先执行 npx skills add dapi/tgcli --skill tgcli --agent '*' -g -y 添加技能，再执行 npm install -g @dapi/tgcli 安装 CLI，首次使用运行 tgcli auth 完成认证。
主要能力覆盖：读取、搜索与归档消息（messages list/show/context/search），发送文本、照片和文件（send text/photo/file），下载消息媒体（media download），列出与管理频道、话题、联系人、群组、文件夹、标签与元数据缓存，以及创建和管理同步任务（sync jobs）。群组管理支持加入申请审批、改名、增删成员和邀请链接管理。
使用方式：智能体工作流建议始终加 --json，并默认加 --timeout 30s，重负载归档读取可用 --timeout 90s。数据源用 --source archive|live|both 明确指定；时间范围用 --after/--before 的 ISO 时间戳，不支持 --since。多账号通过全局 --account 选项或 TGCLI_ACCOUNT 选择，命名档案之间配置、会话与数据库相互隔离。发送格式由 --parse-mode markdown|html|none 控制，多行文本建议通过 scripts/send_text.py 用 stdin 传入。
限制与注意事项：tgcli 侧重读取、搜索、归档、发送与群组管理，编辑、删除、转发、表情回应及部分高级交互动作需使用 telegram-mcp。同步需先用 sync jobs add --chat 入队再以 sync --once 或 --follow 执行，顶层不支持 sync --chat。某些命令要求管理员权限，且不要删除锁文件，应等待重试。具体收费、平台支持和效果资料暂未提供。