ClawHub Telegram Skills 完整盘点：89 个 Skills 分类与选型指南

ClawHub 上共有 89 个 Telegram 专项 Skills，49% 有真实安装记录。本文按技术层和功能维度分 10 个分类整理，核心分野是两条接入路线——Bot API（官方 REST，门槛低但只能访问 Bot 直接参与的对话）与 MTProto 用户协议（Telethon/Pyrogram，能读取任意聊天记录，但需持久化 Session）。语音消息处理是 Telegram 区别于其他

Standalone28

474人浏览 · 2026-03-26 13:45:33

Standalone28 · 2026-03-26 13:45:33 发布

原文地址： https://clawhub-skills.com/blog/telegram-skills-complete-guide-zh
点击原文链接可查看最新数据。

摘要： ClawHub 上共有 89 个 Telegram 专项 Skills，49% 有真实安装记录。本文按技术层和功能维度分 10 个分类整理，核心分野是两条接入路线——Bot API（官方 REST，门槛低但只能访问 Bot 直接参与的对话）与 MTProto 用户协议（Telethon/Pyrogram，能读取任意聊天记录，但需持久化 Session）。语音消息处理是 Telegram 区别于其他平台的典型场景，涉及 .ogg 格式要求和 asVoice=true 参数等底层细节。主力 Skill telegram 以 40 次安装领跑，telegram-bot-builder（中文，含键盘与 Webhook）和 telegram-offline-voice（本地语音生成，无需 API Key）是中文用户最常用的两个专项工具。

背景

Telegram 提供两种技术接入层：

Bot API：官方 REST 接口，通过 BotFather 创建 Bot Token 后即可使用。支持发送消息、处理命令、管理键盘/内联按钮、接收 Webhook 事件。限制：Bot 只能访问它直接参与的对话，无法读取历史记录。
MTProto（用户 API）：Telegram 底层协议，通过 api_id + api_hash + 用户会话实现完整访问——任意聊天记录、频道、个人对话。常用库：Python 的 Telethon、Pyrogram。代价是需要持久化存储用户 Session，存在安全风险。

语音消息是 Telegram 特有的原生功能。技术细节：Telegram 语音消息必须是 .ogg 格式，且 API 调用需设置 asVoice=true 参数，否则会以普通音频文件形式发送，不触发语音消息 UI。

截止 2026 年 3 月 20 日，ClawHub 上共收录 89 个 Telegram 专项 Skills，49% 有真实安装记录。

快速安装：

clawhub install telegram                    # Bot API（推荐起点）
clawhub install telegram-bot                # Bot 构建，覆盖同类范围
clawhub install telegram-compose            # 富文本 HTML 消息格式化
clawhub install tg                          # CLI 读取/搜索/发送
clawhub install telegram-bot-builder        # 键盘 + Webhook + 自动回复（中文）
clawhub install telegram-offline-voice      # 本地语音消息生成（中文）
clawhub install telegram-history            # MTProto 读取聊天记录
clawhub install telegram-cloud-storage      # Teldrive：无限云存储

数据概览

指标	数值
专项 Skills 总数	89
有安装记录（>0）	44（49%）
零安装	45（51%）
下载量最高	postiz — 5,934 次（多平台调度器）
Telegram 原生安装最高	telegram — 40 次
非主力安装最高	telegram-bot-builder — 11 次

一、核心 Bot API 与消息（8 个）

Bot API 层。telegram（40 次安装）和 telegram-bot（23 次安装）是两个主力 Skill，实现范围高度重叠，实际差异在于认证方式（自管 Token vs. 托管 OAuth）和 CLI 设计取向。

关键技术分歧：tg（13 次安装）走 CLI 路线，通过 Shell 管道读取/搜索/发送消息，适合脚本化自动化场景，不需要实现完整的 Webhook 监听逻辑。telegram-compose（14 次安装）专注于 HTML 富文本格式化——Telegram 支持有限的 HTML 标签（<b>, <i>, <code>, <pre>, <a>），以及表格等扩展格式，telegram-compose 封装了这些细节。

telegram-bot-builder（11 次安装，中文）是功能最全的构建器：键盘布局、内联按钮、Webhook 配置、自动回复逻辑一体化，适合需要交互式 Bot 但不想从头搭建的场景。

clawhub install telegram                    # 默认选择
clawhub install telegram-compose            # 需要 HTML 富文本消息
clawhub install telegram-bot-builder        # 需要键盘 + Webhook + 自动回复

#	Skill	下载	安装	简介
1	telegram	4,232	40	Bot API 工作流，命令驱动对话
2	telegram-bot	4,085	23	创建 Bot、发消息、处理命令
3	telegram-compose	3,209	14	通过直接 Bot API 发送富文本 HTML
4	tg	2,306	13	CLI 读取、搜索、发送消息
5	telegram-bot-builder	854	11	键盘、内联按钮、Webhook、自动回复（中文）
6	telegram-api	2,724	7	托管认证，发送消息，管理聊天
7	telegram-bot-manager	1,395	7	管理和配置 OpenClaw 的 Bot
8	telegram-bot-api	315	1	正确的 API 调用、键盘、Webhook

二、语音与音频处理（9 个）

ClawHub Telegram Skills 里最独特的分类，在其他消息平台没有对应物。

技术核心：Telegram 语音消息格式要求 .ogg（Opus 编码），需要设置 asVoice=true 参数。telegram-voice-message-skill 存在的原因正是这个细节——文档化了正确的 OGG 转换流程和参数用法，是调试参考文档而非功能性 Skill。

telegram-offline-voice（12 次安装）的实现路径：本地 TTS 生成 → 音频格式清洗（转为 .ogg Opus）→ 分段处理（Telegram 对单条语音消息有时长限制）→ 通过 Bot API 发送。全程本地，不依赖云端 TTS API，适合隐私敏感或成本敏感的场景。

telegram-voice-to-voice-macos（1 次安装）构建了完整的 Voice-to-Voice 管道：接收用户发来的 .ogg 语音笔记 → Whisper 转录为文本 → AI 处理 → TTS 生成 .ogg → 以语音消息回复。仅适用于 Apple Silicon Mac（依赖本地 Whisper 加速）。

clawhub install telegram-offline-voice      # 本地语音消息生成
clawhub install telegram-voice-transcribe   # Whisper 语音转录

#	Skill	下载	安装	简介
1	telegram-offline-voice	2,925	12	本地语音生成，自动清洗分段（中文）
2	telegram-voice-group	2,591	6	向 Telegram 群组发送语音消息（中文）
3	telegram-voice-transcribe	265	3	Whisper API 转录语音笔记
4	telegram-voice-to-voice-macos	1,180	1	转录 .ogg → 语音回复（Apple Silicon）
5	yandex-speechkit-stt	233	1	俄语 STT（Yandex SpeechKit，Telegram 优先）
6	telegram-multilingual-voice-reply	405	0	按输入类型自动文字或语音回复
7	telegram-voice-mode	372	0	切换语音回复模式开/关
8	telegram-voice	107	0	转录入站语音，自动回复
9	telegram-voice-message-skill	153	0	OGG + asVoice 参数指南（调试参考）

三、论坛与群组管理（5 个）

Telegram 的"论坛模式"（超级群组内的话题线程）通过 Bot API 的 message_thread_id 参数实现。telegram-auto-topic（5 次安装）监听消息中的 /topic 命令，自动调用 createForumTopic API 创建新话题并将当前对话切换进去。

telegram-agent-coordination（零安装）解决了一个真实的多 Agent 工程问题：当多个 AI Agent 共用一个 Telegram 群时，如何避免消息冲突和指令歧义——它定义了 Agent 间的通信协议规范，而不是封装 API。

#	Skill	下载	安装	简介
1	telegram-auto-topic	2,523	5	从 /topic 命令自动创建论坛话题
2	telegram-ops	1,396	5	通过 Bot API 创建/编辑/归档话题
3	tg-groupchat-setup	1,464	0	为 MoltBot Agent 配置群聊
4	telegram-topic-rename	675	0	重命名话题和更改图标
5	telegram-agent-coordination	108	0	多 Agent 共用群聊的协调协议

四、消息历史与 MTProto 访问（6 个）

Bot API 限制 Bot 只能访问直接接收的消息。读取任意聊天历史、频道帖子、用户对话，需要切换到 MTProto（用户 API）。

技术实现：MTProto Sessions 需要持久化存储（通常是 .session 文件），包含用户 API 密钥和加密的会话令牌。这是安全敏感点——Session 文件泄露等同于账户访问权限泄露。这解释了为什么 MTProto 类 Skills 安装量整体低于 Bot API 类。

telegram-history（6 次安装）直接使用 Telethon，relay-for-telegram（1 次安装）封装了一个"最佳实践"的 MTProto 读取器，处理了速率限制和 Session 持久化细节。

clawhub install telegram-history            # MTProto 读取聊天历史（Telethon）

#	Skill	下载	安装	简介
1	telegram-history	669	6	通过 Telethon（MTProto）获取聊天记录
2	relay-for-telegram	2,049	1	最佳实践消息历史访问方式
3	sergei-mikhailov-tg-channel-reader	722	1	频道帖子 + 评论（Pyrogram/Telethon）
4	lifequery	160	1	通过 LifeQuery 实例查询 Telegram 历史
5	tg-mtproto-cli	378	0	只读：列出聊天、获取消息、下载媒体
6	telegram-readonly	71	0	通过 Telethon 的受控只读访问

五、OpenClaw Agent 集成（10 个）

最具 OpenClaw 特色的分类。这些 Skills 修改的是 OpenClaw 平台内部的 Telegram 配对流程，而不是封装 Telegram 的公开 API。

配对集群尤为值得关注：4 个独立 Skills（telegram-pairing-message-customization、telegram-pairing-customization、telegram-pairing-approver、telegram-pairing-send-code-to-every-start）都在针对同一个功能点——OpenClaw 内置的 Telegram 设备配对流程——进行不同角度的定制。说明平台没有原生暴露这些配置项，Skills 生态填补了这个空白。

tg-smart-cta（5 次安装）技术上有意思：无需构建完整 Bot，只在现有回复中追加内联 CTA 按钮——通过分析上下文语义决定按钮的类型和文案，让 Agent 回复具备更丰富的 UI 交互能力。

#	Skill	下载	安装	简介
1	telegram-usage	1,561	7	显示 Session 配额、时间、Token 用量
2	agent-telegram	449	9	Agent 团队 Telegram 通信协议
3	tg-smart-cta	1,633	5	回复中的动态上下文感知 CTA 按钮
4	telegram-pairing-approver	1,656	2	持久运行的 Bot 服务，自动批准 Session
5	openclaw-telegram-chat	346	2	跨实例聊天、用户提及、个人 Bot 设置
6	telegram-footer-patch	350	3	在所有私聊回复末尾追加页脚
7	telegram-pairing-message-customization	2,383	1	为未审批用户的配对回复添加自定义文本
8	create-agent-with-telegram-group	399	1	创建 Agent + 绑定专属 Telegram 群组
9	telegram-context	512	0	在 Session 开始时获取近期消息
10	telegram-pairing-customization	1,887	0	在每次 /start 时发送配对码

六、云存储与文件传输（4 个）

telegram-cloud-storage（3 次安装）是整个集合中技术上最有创意的 Skill。实现原理：Telegram Bot 可以上传最大 2GB 的单个文件，且无总存储上限，Teldrive 在此之上提供 FUSE 文件系统接口，将 Telegram 变成可挂载的云存储驱动器。对于成本敏感的场景，这是零费用的 S3/Dropbox 替代方案。

telegram-ascii-table（2 次安装）解决了一个具体的格式化问题：Telegram 支持等宽字体渲染（<pre> 标签），ASCII 盒形表格（┌─┬─┐ 风格）在聊天界面可读性良好，该 Skill 通过 stdin 管道安全地转换表格数据，避免了 Shell 注入风险。

clawhub install telegram-cloud-storage      # Teldrive 无限云存储

#	Skill	下载	安装	简介
1	telegram-cloud-storage	2,019	3	Teldrive：将 Telegram 变为免费无限云存储
2	telegram-ascii-table	1,161	2	表格数据 → Telegram ASCII 盒形表格
3	tsend	419	0	通过 tsend CLI 发送文件（含配置说明）
4	tms	418	0	通过 Telegram Media Server REST API 管理下载

七、提醒与通知（4 个）

Telegram 已成为程序化通知的默认渠道——比 Email 即时，比 Slack 轻量，无需企业订阅。金融场景在这里占主导：rho-telegram-alerts（5 次安装）发送交易持仓更新，带频率限制（防止高频行情推送刷屏）。f5-telegram-notify（1 次安装）是单一用途工具：当 F5-TTS 模型训练完成或失败时发送 Telegram 通知——ML 任务监控的最小实现。

#	Skill	下载	安装	简介
1	telegram-notify	377	6	带频率限制的交易提醒
2	rho-telegram-alerts	581	5	开仓/平仓、持仓更新、市场信号
3	f5-telegram-notify	171	1	F5-TTS 训练完成/失败时通知
4	polymarket-telegram-picks	151	0	每日 Polymarket 赔率 → AI 分析 → 推送

八、Mini App 与富文本 UI（5 个）

Telegram Mini App 是嵌入在 Telegram 内运行的 Web 应用，通过 telegram-web-app.js SDK 暴露 Telegram 提供的视窗、用户数据和支付接口。tg-miniapp（1 次安装）专门文档化了开发中的常见陷阱：安全区域（Safe Area）惯例、全屏 API 限制、以及不同设备上视窗高度的不一致问题——这些细节在官方文档里语焉不详。

telegram-colored-choices-buttons（零安装）解决了 Bot UI 的一个限制：Telegram 内联键盘按钮默认灰色，无法原生区分语义（确认/取消/危险操作）。该 Skill 通过文案规范和 CallbackData 前缀约定，模拟出颜色语义分层。

#	Skill	下载	安装	简介
1	telegram-inline-buttons	243	2	为高频操作添加内联按钮减少输入
2	telegram-interactive-buttons	180	1	通过 OpenClaw CLI 创建交互式内联按钮消息
3	tg-miniapp	854	1	Telegram Mini App 构建器（安全区域、全屏）
4	telegram-colored-choices-buttons	413	0	按钮自动着色：默认/危险/次级
5	telegram-rich-messages	100	0	完整指南：内联按钮、格式化、媒体、反应

九、社交媒体内容发布（2 个）

#	Skill	下载	安装	简介
1	postiz	5,934	18	调度发布到 28+ 渠道（含 Telegram）
2	publora-telegram	393	0	通过 Publora API 发布/调度到 Telegram

十、专项与细分工具（17 个）

#	Skill	下载	安装	简介
1	telegram-todolist	640	1	通过 Telegram 命令管理 TODO.md
2	minimax-to-telegram	556	3	MiniMax 生成图片/音频/视频 → Telegram
3	openclaws	1,853	2	AI 代理去中心化社交网络
4	telegram-business	180	1	商业 Bot：线索收集、FAQ、内联菜单
5	phy-openclaw-telegram-bot	148	1	生产级 OpenClaw Telegram Bot 部署
6	telegram-marketing-audit-adarsh	146	1	Instagram 审计 → 通过 Telegram 命令触发
7	telegram-openapi-skill	66	1	通过 OpenAPI Schema + Bot Token 路径认证
8	telegram-pairing-send-code-to-every-start	894	0	未审批用户每次 /start 都发送配对码
9	telegram-bot-factory	516	0	构建支付/交易/调度 Bot（中文）
10	macos-screenshot-telegram	516	0	macOS 截图 → 发送到 Telegram
11	telegram-discord-bot-dev	394	0	定制 Telegram + Discord Bot
12	apipick-telegram-phone-check	357	0	检查手机号是否注册了 Telegram
13	telegram-chat-to-image	247	0	将聊天导出转为长截图图片
14	telegram-autopilot	117	0	Userbot 自动驾驶：AI 以用户身份回复私信
15	telegram-premium-features	82	0	Telegram Premium 功能变现实现指南
16	anthrovision-telegram-body-scan	922	0	通过 AnthroVision 在 Telegram 中运行身体测量
17	chia-walletconnect	1,338	0	通过 WalletConnect + Telegram Web App 验证 Chia 钱包

选型建议

需求	推荐
构建 Telegram Bot（默认）	telegram
富文本 HTML 消息格式化	telegram-compose
CLI 脚本化读取/发送	tg
键盘 + Webhook + 自动回复	telegram-bot-builder
本地语音消息生成	telegram-offline-voice
Whisper 语音转录	telegram-voice-transcribe
MTProto 读取聊天历史	telegram-history
读取频道帖子 + 评论	sergei-mikhailov-tg-channel-reader
无限云存储（Teldrive）	telegram-cloud-storage
多平台调度（含 Telegram）	postiz
Telegram Mini App 开发	tg-miniapp
金融/交易提醒	rho-telegram-alerts
OpenClaw 配对流程定制	telegram-pairing-approver