Telegram机器人管理

技能简介

该技能提供完整的Telegram Bot API操作能力，支持从命令行直接创建机器人、发送各类消息、配置Webhook以及管理群组和频道。

能做什么

• 创建新机器人并获取访问令牌
• 发送文本、图片、文档、位置等多媒体消息
• 配置内联键盘和回复键盘交互界面
• 设置和管理Webhook接收实时更新
• 查询群组信息和成员数量
• 轮询获取消息更新

使用说明

安装准备

需预先安装以下工具：

# Ubuntu/Debian
sudo apt-get install jq curl

# macOS
brew install jq curl

配置环境变量

1. 在Telegram中联系 @BotFather
2. 发送 /newbot 并按提示创建机器人
3. 复制获得的令牌（格式如 123456789:ABCdefGHIjklMNOpqrsTUVwxyz）
4. 设置环境变量：

   export TELEGRAM_BOT_TOKEN="your-bot-token"

基础调用格式

所有请求发送至：https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/METHOD_NAME

常用操作示例

获取机器人信息：

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 from Clawdbot!",
    "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",
    "allowed_updates": ["message", "callback_query"]
  }' | jq

输入与输出

见下方输入与输出表格。

风险提示

• Bot Token具有完整控制权限，泄露后他人可冒充机器人发送消息
• Webhook URL需使用HTTPS且具备有效SSL证书
• 频繁调用API可能触发速率限制
• 存储用户聊天ID需遵守数据保护法规

来源信息

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