mcpField
T
telegram-reminders

telegram-reminders

github.com/alexskuznetsov生产力2151 次安装41 周前更新
代码仓库

关于 telegram-reminders

此 skill 通过 Convex Cloud 即时发送 Telegram 消息或安排提醒。它提供处理附件、管理定时消息和查看消息历史的脚本。

主要功能

  1. 01即时发送 Telegram 消息
  2. 02安排带附件的消息
  3. 03查看并取消待发送消息
  4. 04查看消息历史
  5. 05按配置时区安排发送

适用场景

  1. 01立即发送 Telegram 通知
  2. 02安排附带文档的提醒
  3. 03检查或取消已安排的消息

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/alexskuznetsov/claude-skill-telegram --skill telegram-reminders

安装后在 Claude Code 中输入/telegram-reminders确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
README.md
package-lock.json
package.json
tsconfig.json
convex/
crons.ts
telegram.ts
messages.ts
tsconfig.json
schema.ts
references/
architecture.md
error_handling.md
convex.md
telegram_api.md
initial_setup.md
scripts/
cancel_message.ts
send_message.ts
list_scheduled.ts
proxy-util.ts
logger.ts
schedule_message.ts
setup.ts
types.ts
view_history.ts

详细介绍

Telegram 提醒技能

通过 Convex 提供的云端调度功能，即时发送消息并安排 Telegram 提醒。提醒会在 Convex Cloud 中全天候运行，无需管理任何基础设施。

快速参考

重要！请始终按顺序使用以下命令：

  • 立即发送：tsx scripts/send_message.ts [message_text]
  • 立即发送并附加文件：tsx scripts/send_message.ts [message_text] /path/to/file.pdf
  • 安排发送：tsx scripts/schedule_message.ts [time expression] [title] [message_text] [file_path]
  • 安排发送并附加文件：tsx scripts/schedule_message.ts [time expression] [title] [message_text] /path/to/file
  • 列出待发送消息：tsx scripts/list_scheduled.ts
  • 取消：tsx scripts/cancel_message.ts <message_id>
  • 历史记录：tsx scripts/view_history.ts [limit]

初始设置

前提条件（用户必须提供）：

  1. Bot Token：向 @BotFather 发送消息 → /newbot → 复制令牌
  2. User ID：向 @userinfobot 发送消息 → 复制数字 ID
  3. Deploy Key：访问 dashboard.convex.dev → 创建项目 → Settings → Deploy Keys → 创建“Production”密钥

设置步骤：

# 1. Install dependencies
cd /mnt/skills/user/telegram-reminders && npm install

# 2. Save configuration
mkdir -p /mnt/user-data/outputs
cat > /mnt/user-data/outputs/telegram_config.json << 'EOF'
{
  "botToken": "YOUR_BOT_TOKEN",
  "userId": "YOUR_USER_ID",
  "deployKey": "YOUR_DEPLOY_KEY",
  "setupDate": "CURRENT_DATE"
}
EOF

# 3. Create .env.local
cat > .env.local << 'EOF'
CONVEX_DEPLOY_KEY=YOUR_DEPLOY_KEY
EOF


# 4. Set environment variables in Convex
npx convex env set TELEGRAM_BOT_TOKEN "YOUR_BOT_TOKEN"
npx convex env set TELEGRAM_USER_ID "YOUR_USER_ID"

# 5. Deploy to Convex
npx convex deploy

# 6. Test with a message
tsx scripts/send_message.ts "Setup complete!"

重要：用户必须先与自己的机器人开启聊天（搜索机器人并点击“Start”），机器人才能发送消息。

核心操作

发送即时消息

发送文本消息：

tsx scripts/send_message.ts "Your message text here"

包含特殊字符的示例：

tsx scripts/send_message.ts "Hello! Here's a test message 🚀"

时区

所有时间均使用用户配置的时区。Convex 后端在内部以 UTC 存储时间；客户端脚本通过 chrono-node 处理时区转换。

限制

  • 文件将作为文档发送（而非内嵌图片）
  • 文件大小上限：50MB（Telegram 限制）
  • Cron 最小粒度：1 分钟
  • 无法编辑消息（请改为取消并重新安排）
  • 速率限制：每位用户每分钟 20 条消息

参考资料

评论

支持 Markdown