Telegram Bot

使用说明

Telegram Bot Skill 让 Agent 通过 Telegram Bot API 与用户交互——发消息、管群组、处理命令和回调按钮。

clawhub install telegram-bot

核心功能

• 消息发送：文本、Markdown、HTML 格式，支持定时发送和静默消息
• 内联键盘：交互按钮和回调查询，构建对话式工作流
• 群组管理：踢人、禁言、置顶消息、获取成员列表
• 文件发送：图片、文档、视频、音频
• Webhook 管理：自动设置和更新 Webhook URL

配置

export TELEGRAM_BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

使用示例

发消息给 Chat ID 12345：「部署完成，版本 v3.0」

发一张截图到监控群

给群成员发送投票：「今天几点开会？」

适用场景

• 运维告警推送到 Telegram 群
• 用户通过 Bot 触发 Agent 任务
• 定时报告发送
• 群内交互式命令处理

注意事项

1. Bot 无法主动给未对话过的用户发消息
2. 群组中 Bot 需要有管理员权限才能置顶和踢人
3. 消息长度限制 4096 字符，超长需分段
4. Webhook 需要有效 SSL 证书