Telegram — 技能工具
v1.0.1OpenClaw skill for designing Telegram Bot API workflows and command-driven conversations using direct HTTPS requests (no SDKs).
20· 1.6万·218 当前·227 累计
by @codedao12运行时依赖
无特殊依赖
安装命令
点击复制官方npx clawhub@latest install telegram
镜像加速npx clawhub@latest install telegram --registry https://cn.longxiaskill.com 镜像可用
本土化适配说明
Telegram — 技能工具 安装说明： 安装命令：["openclaw skills install telegram"] 支持国内镜像加速，使用 --registry https://cn.longxiaskill.com 参数可加速下载
技能文档
目的
提供干净、面向生产的指南，用于通过 Bot API 构建 Telegram 机器人工作流，专注于命令 UX、更新处理和使用纯 HTTPS 的安全操作。
最佳适用场景
- 你想要一个命令优先、表现专业的机器人
- 你需要可靠的更新流（webhook 或轮询）
- 你更喜欢直接 HTTP 调用而不是库
不适用场景
- 你需要完整的 SDK 或框架集成
- 你需要复杂的媒体上传和流式处理
快速入门
- 阅读 references/telegram-bot-api.md 了解端点、更新类型和请求模式
- 阅读 references/telegram-commands-playbook.md 了解命令 UX 和消息风格
- 阅读 references/telegram-update-routing.md 了解更新规范化和路由规则
- 阅读 references/telegram-request-templates.md 了解 HTTP 负载模板
- 保持此 SKILL.md 简短，使用 references 存放详细信息
必需输入
- Bot token 和基础 API URL
- 更新策略：webhook 或长轮询
- 命令列表和对话风格
- 允许的更新类型和速率限制策略
预期输出
- 清晰的命令设计、更新流计划和操作检查清单
操作注意事项
- 首选严格的命令路由：/start、/help、/settings、/status
- 始终验证传入的更新负载和聊天上下文
- 使用退避策略处理 429 错误，避免消息爆发
安全注意事项
- 永远不要记录 token
- 尽可能使用带有秘密令牌头的 webhook