Telegram Bot 构建技能

直接从 Clawdbot 构建和管理 Telegram 机器人。

设置

1. 1. 打开 Telegram 并向 @BotFather 发送消息
2. 发送 /newbot 并按照提示创建你的机器人
3. 复制机器人令牌（格式如 123456789:ABCdefGHIjklMNOpqrsTUVwxyz）
4. 设置环境变量：

bash export TELEGRAMBOTTOKEN=你的机器人令牌

API 基础地址

所有请求发送至：

https://api.telegram.org/bot$TELEGRAMBOTTOKEN/METHOD_NAME

使用方法

机器人信息

获取机器人信息

bash curl -s https://api.telegram.org/bot$TELEGRAMBOTTOKEN/getMe | jq

获取机器人命令

bash curl -s https://api.telegram.org/bot$TELEGRAMBOTTOKEN/getMyCommands | jq

设置机器人命令

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/setMyCommands \ -H Content-Type: application/json \ -d { commands: [ {command: start, description: 启动机器人}, {command: help, description: 显示帮助信息}, {command: settings, description: 机器人设置} ] } | jq

发送消息

发送文本消息

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/sendMessage \ -H Content-Type: application/json \ -d { chatid: CHATID, text: 来自 Clawdbot 的问候！, parse_mode: HTML } | jq

发送带内联键盘的消息

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/sendMessage \ -H Content-Type: application/json \ -d { chatid: CHATID, text: 请选择一个选项：, reply_markup: { inline_keyboard: [ [{text: 选项 1, callbackdata: opt1}, {text: 选项 2, callbackdata: opt2}], [{text: 访问网站, url: https://example.com}] ] } } | jq

发送带回复键盘的消息

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/sendMessage \ -H Content-Type: application/json \ -d { chatid: CHATID, text: 请从键盘选择：, reply_markup: { keyboard: [ [{text: 按钮 1}, {text: 按钮 2}], [{text: 发送位置, request_location: true}] ], resize_keyboard: true, onetimekeyboard: true } } | jq

发送图片

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/sendPhoto \ -F chatid=CHATID \ -F photo=@/path/to/image.jpg \ -F caption=图片说明 | jq

通过 URL 发送图片

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/sendPhoto \ -H Content-Type: application/json \ -d { chatid: CHATID, photo: https://example.com/image.jpg, caption: 来自 URL 的图片 } | jq

发送文档

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/sendDocument \ -F chatid=CHATID \ -F document=@/path/to/file.pdf \ -F caption=这是你的文档 | jq

发送位置

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/sendLocation \ -H Content-Type: application/json \ -d { chatid: CHATID, latitude: 40.7128, longitude: -74.0060 } | jq

获取更新

获取更新（轮询）

bash curl -s https://api.telegram.org/bot$TELEGRAMBOTTOKEN/getUpdates | jq

带偏移量获取更新（标记为已读）

bash curl -s https://api.telegram.org/bot$TELEGRAMBOTTOKEN/getUpdates?offset=UPDATE_ID | jq

带超时获取更新（长轮询）

bash curl -s https://api.telegram.org/bot$TELEGRAMBOTTOKEN/getUpdates?timeout=30 | jq

Webhooks

设置 Webhook

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/setWebhook \ -H Content-Type: application/json \ -d { url: https://your-server.com/webhook, allowedupdates: [message, callbackquery] } | jq

获取 Webhook 信息

bash curl -s https://api.telegram.org/bot$TELEGRAMBOTTOKEN/getWebhookInfo | jq

删除 Webhook

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/deleteWebhook | jq

聊天管理

获取聊天信息

bash curl -s https://api.telegram.org/bot$TELEGRAMBOTTOKEN/getChat?chatid=CHATID | jq

获取聊天成员数量

bash curl -s https://api.telegram.org/bot$TELEGRAMBOTTOKEN/getChatMemberCount?chatid=CHATID | jq

获取聊天管理员

bash curl -s https://api.telegram.org/bot$TELEGRAMBOTTOKEN/getChatAdministrators?chatid=CHATID | jq

封禁聊天用户

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/banChatMember \ -H Content-Type: application/json \ -d { chatid: CHATID, userid: USERID } | jq

解封用户

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/unbanChatMember \ -H Content-Type: application/json \ -d { chatid: CHATID, userid: USERID, onlyifbanned: true } | jq

消息管理

编辑消息文本

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/editMessageText \ -H Content-Type: application/json \ -d { chatid: CHATID, messageid: MESSAGEID, text: 更新后的消息文本 } | jq

删除消息

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/deleteMessage \ -H Content-Type: application/json \ -d { chatid: CHATID, messageid: MESSAGEID } | jq

置顶消息

bash curl -s -X POST https://api.telegram.org/bot$TELEGRAMBOTTOKEN/pinChatMessage \ -H Content-Type: application/json \ -d { chatid: CHATID, messageid: MESSAGEID } | jq

转发消息

bash curl -s -X POST https://api.