Telegram机器人创建

技能简介

该技能通过Telegram Bot API实现机器人的创建与管理，支持发送文本、图片、文档、位置等多类型消息，处理Webhook回调，以及管理群组和频道。

能做什么

• 创建并配置Telegram机器人基础信息
• 发送文本、图片、文档、地理位置等消息
• 设置内联键盘与回复键盘交互界面
• 配置Webhook接收实时消息推送
• 获取群组/频道成员信息与管理员列表
• 使用轮询方式获取用户更新消息

使用说明

安装准备

需预先安装以下依赖：

# Debian/Ubuntu
sudo apt-get install jq curl

# macOS
brew install jq curl

获取Bot Token

1. 在Telegram中联系 @BotFather
2. 发送 /newbot 并按提示完成创建
3. 复制获得的token（格式如：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）
4. 设置环境变量：export TELEGRAM_BOT_TOKEN="your-bot-token"

常用操作示例

获取机器人信息：

curl -s "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/getMe" | jq

发送文本消息：

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!", "parse_mode": "HTML"}' | jq

设置Webhook：

curl -s -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/setWebhook" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-server.com/webhook"}' | jq

输入与输出

见下方输入与输出表格。

风险提示

• Bot Token泄露将导致他人控制你的机器人，请妥善保管
• Webhook地址需使用HTTPS且可被公网访问
• 频繁调用API可能触发Telegram速率限制
• 发送消息前需确认目标chat_id正确，避免信息误发

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jordanprater/telegram-create-bot/SKILL.md
来源类型：GitHub仓库