SuperAPI AI 工具集

telegram-bot

办公与效率

查看项目

更新于 10-16 08:09

技能介绍

用途:该技能用于在 Clawdbot 中通过 Telegram Bot API 构建和管理 Telegram 机器人,涵盖创建机器人、发送消息、处理 webhook、管理群组与频道。

准备工作:在 Telegram 中向 @BotFather 发消息,发送 /newbot 并按提示创建机器人,复制形如 123456789:ABCdefGHIjklMNOpqrsTUVwxyz 的令牌,然后设置环境变量:export TELEGRAM_BOT_TOKEN="your-bot-token"。所有请求发往 https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/METHOD_NAME。

主要能力:查询机器人信息(getMe、getMyCommands)与设置命令(setMyCommands);发送文本、内联键盘、回复键盘、图片、文档、位置等消息;通过 getUpdates 轮询或 setWebhook 设置 webhook 获取更新,并可查询与删除 webhook;获取聊天信息、成员数与管理员,封禁或解封用户;编辑、删除、置顶、转发消息;回调查询应答(answerCallbackQuery)。

使用方式:以 curl 调用 API,例如发送文本:curl -s -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/sendMessage" -H "Content-Type: application/json" -d '{"chat_id": "CHAT_ID", "text": "Hello from Clawdbot!", "parse_mode": "HTML"}' | jq。支持 HTML、Markdown、MarkdownV2 解析模式;可参考文档中的简单回声机器人 bash 脚本。

适用场景:需要以脚本或命令行方式创建 Telegram 机器人、群组与频道管理、消息推送、回调按钮交互,以及通过 webhook 或长轮询接收更新的场景。

限制:聊天 ID 可能为正(用户)或负(群组/频道);限速约每秒 30 条发往不同聊天、每秒 1 条发往同一聊天;图片最大 10MB、文档最大 50MB;机器人无法主动给用户发消息,需用户先 /start。其他收费、价格与平台信息暂未提供。