claude-skill-telegram
通过Telegram Bot发送即时消息和定时提醒的云端技能
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：claude-skill-telegram。 它的用途是：通过Telegram Bot发送即时消息和定时提醒的云端技能 完整的 Skill 内容见：https://321skill.com/skills/claude-skill-telegram/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我把‘本周五下午3点与客户进行项目评审’这个提醒设置到Telegram上。”，它会引导你使用 `npm run schedule "friday 3pm" "客户评审" "项目最终方案评审，请准时参加"` 命令，将提醒精准地安排到指定时间。或者，当AI生成了一个重要的代码解决方案后，你可以说：“把这个解决方案的关键步骤发到我手机上。”，AI会建议你使用 `npm run send` 命令，将内容即时推送到你的Telegram。
介绍
这个Skill解决了在Claude环境中无法直接、可靠地接收异步通知或设置定时提醒的问题。它通过将Telegram Bot作为消息接收端，并利用Convex云平台提供7x24小时的定时任务调度服务，实现了消息的即时发送与精准定时推送。用户只需完成一次性的Bot和Convex配置，即可通过简单的命令行工具发送消息或设置未来的提醒。
使用过程非常简便。首先，用户需要在Telegram上创建Bot并获取自己的用户ID，同时在Convex平台注册并获取部署密钥。然后，运行一次性的npm run setup命令完成配置。之后，就可以通过npm run send发送即时消息，或使用npm run schedule设置如“明天上午10点开会”这样的定时提醒。所有已安排和已发送的消息都可以通过list和history命令查看。
该Skill非常适合需要跨会话、跨设备接收重要通知或管理个人待办事项的用户。例如，远程工作者可以用它接收任务完成通知，学生可以用它设置作业提交提醒，或者任何需要将Claude对话中的关键信息（如生成的代码片段、总结的要点）即时推送到手机的用户。
使用建议方面，请务必先在Telegram上与创建好的Bot发起对话（点击“Start”），否则Bot无法向您发送消息。由于依赖外部网络，在Claude沙盒环境中运行时，请确保代理设置正确，脚本已配置使用undici和ProxyAgent来处理网络请求，以避免出现“fetch failed”等连接问题。
核心特点
核心区别在于其云端架构：利用Convex的免费云服务提供7x24小时可靠的定时任务调度，无需用户自建或维护服务器；同时，通过共享的代理工具脚本，专门优化了在Claude沙盒等受限网络环境下的连接稳定性。
注意事项
不适合对消息送达实时性要求极高（如秒级警报）或需要在完全离线的内网环境中使用的场景。
常见问题
消息没有发送到Telegram怎么办？
请先确认已在Telegram上搜索到您的Bot并点击了“Start”按钮，这是Bot能向您发送消息的前提。
运行脚本时出现网络错误？
Claude沙盒通常设有代理，请确认环境变量`HTTP_PROXY/HTTPS_PROXY`已设置，并且脚本使用了项目中的`proxy-util.ts`来配置全局网络调度器。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/claude-skill-telegram/raw/index.md 读取 claude-skill-telegram 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/claude-skill-telegram/raw/index.md（查看排版版本）