---

name: telegram-automation description: "通过Rube MCP（Composio）自动化Telegram任务：发送消息、管理聊天、分享照片/文档和处理机器人命令。始终先搜索工具以获取当前schema。" risk: critical source: community date_added: "2026-02-27"

通过Rube MCP实现Telegram自动化

通过Composio的Telegram工具包经由Rube MCP自动化Telegram操作。

前置条件

• 必须连接Rube MCP（RUBE_SEARCH_TOOLS可用）
• 通过RUBE_MANAGE_CONNECTIONS使用toolkit telegram建立活跃的Telegram连接
• 始终先调用RUBE_SEARCH_TOOLS获取当前工具schema
• 需要Telegram Bot Token（通过@BotFather创建）

设置

获取Rube MCP：在你的客户端配置中添加https://rube.app/mcp作为MCP服务器。无需API密钥——只需添加端点即可使用。

1. 通过确认RUBE_SEARCH_TOOLS响应来验证Rube MCP可用
2. 使用toolkit telegram调用RUBE_MANAGE_CONNECTIONS
3. 如果连接不是ACTIVE状态，按照返回的认证链接配置Telegram机器人
4. 在运行任何工作流之前确认连接状态显示ACTIVE

核心工作流

1. 发送消息

适用场景：用户想要向Telegram聊天发送文本消息

工具序列：

1. TELEGRAM_GET_ME - 验证机器人身份和连接 [前置条件]
2. TELEGRAM_GET_CHAT - 获取聊天详情并验证访问权限 [可选]
3. TELEGRAM_SEND_MESSAGE - 发送文本消息 [必需]

关键参数：

• chat_id：数字聊天ID或频道用户名（如'@channelname'）
• text：消息文本内容
• parse_mode：'HTML'或'MarkdownV2'用于格式化
• disable_notification：静默发送，无通知声音
• reply_to_message_id：要回复的消息ID

注意事项：

• 机器人必须是聊天/群组的成员才能发送消息
• MarkdownV2需要转义特殊字符：_*[]()~>#+-=|{}.!
• HTML模式支持有限标签：<b>、<i>、<code>、<pre>、<a>
• 消息有4096字符限制；较长内容需要拆分

2. 发送照片和文档

适用场景：用户想要在Telegram聊天中分享图片或文件

工具序列：

1. TELEGRAM_SEND_PHOTO - 发送图片 [可选]
2. TELEGRAM_SEND_DOCUMENT - 发送文件/文档 [可选]

关键参数：

• chat_id：目标聊天ID
• photo：照片URL或file_id（用于SEND_PHOTO）
• document：文档URL或file_id（用于SEND_DOCUMENT）
• caption：媒体的可选说明文字

注意事项：

• 照片说明文字有1024字符限制
• 文档说明文字也有1024字符限制
• 通过Bot API可发送最大50MB的文件
• 照片会被Telegram压缩；使用SEND_DOCUMENT发送未压缩图片

3. 管理聊天

适用场景：用户想要获取聊天信息或管理聊天设置

工具序列：

1. TELEGRAM_GET_CHAT - 获取详细聊天信息 [必需]
2. TELEGRAM_GET_CHAT_ADMINISTRATORS - 列出聊天管理员 [可选]
3. TELEGRAM_GET_CHAT_MEMBERS_COUNT - 获取成员数量 [可选]
4. TELEGRAM_EXPORT_CHAT_INVITE_LINK - 生成邀请链接 [可选]

关键参数：

• chat_id：目标聊天ID或用户名

注意事项：

• 机器人必须是管理员才能导出邀请链接
• GET_CHAT对私聊、群组和频道返回不同字段
• 超大群组的成员数量可能是近似值
• 管理员列表不包含普通成员

4. 编辑和删除消息

适用场景：用户想要修改或删除之前发送的消息

工具序列：

1. TELEGRAM_EDIT_MESSAGE - 编辑已发送的消息 [可选]
2. TELEGRAM_DELETE_MESSAGE - 删除消息 [可选]

关键参数：

• chat_id：消息所在的聊天
• message_id：要编辑或删除的消息ID
• text：新文本内容（用于编辑）

注意事项：

• 机器人只能编辑自己的消息
• 消息只能在发送后48小时内删除
• 在群组中，具有删除权限的机器人可以删除任何消息
• 编辑消息会移除其"已编辑"时间戳历史

5. 转发消息和获取更新

适用场景：用户想要转发消息或获取最近的更新

工具序列：

1. TELEGRAM_FORWARD_MESSAGE - 将消息转发到另一个聊天 [可选]
2. TELEGRAM_GET_UPDATES - 获取最近的机器人更新/消息 [可选]
3. TELEGRAM_GET_CHAT_HISTORY - 获取聊天消息历史 [可选]

关键参数：

• from_chat_id：转发的源聊天
• chat_id：转发的目标聊天
• message_id：要转发的消息
• offset：GET_UPDATES的更新偏移量
• limit：要获取的更新数量

注意事项：

• 转发的消息会显示原始发送者归属
• GET_UPDATES返回有限窗口的最近更新
• 聊天历史访问可能受机器人权限和聊天类型限制
• 使用offset避免重复处理同一更新

6. 管理机器人命令

适用场景：用户想要设置或更新机器人命令菜单

工具序列：

1. TELEGRAM_SET_MY_COMMANDS - 设置机器人命令列表 [必需]
2. TELEGRAM_GET_MY_COMMANDS - 获取当前命令列表 [可选]
3. TELEGRAM_DELETE_MY_COMMANDS - 删除命令列表 [可选]

注意事项：

• 命令必须以小写字母开头
• 命令描述限制为256个字符
• 可以为不同的作用域设置不同的命令（所有聊天、群组、私聊）