SuperAPI AI 工具集

telegram

编程与开发

查看项目

更新于 10-16 04:53

技能介绍

用途:该技能为 Bub 提供 Telegram 出站通信能力,通过 Telegram Bot API 向用户、群组或频道发送、回复和编辑消息。

主要能力:支持普通文本消息发送、回复指定消息、编辑已有消息;支持 Rich Message(Bot API 10.1+),可用 HTML 或 Markdown 富文本标记,涵盖标题、列表、表格、引用、折叠 details、带说明媒体、数学块、代码块等结构化格式。

使用方式:需配置环境变量 BUB_TELEGRAM_TOKEN=${config.telegram.token}。执行前需收集 chat_id(必填)、message_id(编辑或回复时必填)、消息内容(发送/编辑时必填)、reply_to_message_id(线程回复时必填)。结构化消息优先使用 telegram_rich.py,短单段回复可用 telegram_send.py。消息内容应通过 heredoc 管道经 stdin 传入(--message - 或 --text -),避免直接写在 shell 参数中。示例:cat << 'EOF' | uv run ${SKILL_DIR}/scripts/telegram_send.py --chat-id <CHAT_ID> --token "$BUB_TELEGRAM_TOKEN" --message -。编辑消息使用 telegram_edit.py,富消息编辑使用 telegram_rich.py --edit <MESSAGE_ID>。多行富 HTML 建议用 --html-file 读取文件。

执行策略:若来源消息发送者是机器人(sender_is_bot=true),不使用回复模式,改为普通消息并以 @username 或 tg://user?id= 链接提及;长任务可先发一条进度消息再编辑为最终状态;语音消息先转写再回复,优先语音输出,不可用时回退文本;仅需确认时可用 Telegram reaction。

限制:Rich Message 需 Bot API 10.1+;html 与 markdown 二者只能提供一个;群组中与其他机器人通信需直接回复其消息或使用 /command@OtherBot 显式命令,自由文本不保证送达。其他未覆盖操作可用 curl 直接调用 Bot API。