mcpField
T
telegram

telegram

github.com/sanjay3290生产力44886 次安装7 周前更新
代码仓库

关于 telegram

基于 Bash 的 Telegram 技能，可发送提醒和文件、读取回复，并运行提问后等待审批的流程。它使用 curl 和 jq，通过 Bot token 设置，也可配置 Claude Code hooks。

主要功能

  1. 01发送消息和提醒
  2. 02发送文件并自动识别照片
  3. 03读取收到的消息
  4. 04发送限时选项问题
  5. 05配置多个 Bot 和目标

适用场景

  1. 01Claude 需要输入时通知 Telegram 聊天
  2. 02发送部署完成提醒
  3. 03部署前要求通过 Telegram 回复审批

安装

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

$npx skills add https://github.com/sanjay3290/ai-skills --skill telegram

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

附带文件README.mdscripts/telegram.sh

详细介绍

Telegram

向 Telegram 发送更新、提醒和文件；读取回复；运行提问并等待批准的工作流。纯 bash + curl + jq — 除机器人令牌外，无需安装。

首次运行：scripts/telegram.sh setup（BotFather 引导流程）。

命令

scripts/telegram.sh send "Deploy finished ✅"                    # basic alert
scripts/telegram.sh send "low priority" --silent                # no notification sound
scripts/telegram.sh send "*bold* alert" --format md             # MarkdownV2 (falls back to plain)
scripts/telegram.sh send "hi" --to alerts --bot work            # named target + named bot
scripts/telegram.sh file report.pdf "Q3 report"                 # document (photos auto-detected)
scripts/telegram.sh read                                        # new incoming messages since last read
ANSWER=$(scripts/telegram.sh ask "Deploy to prod?" --options "Yes,No" --timeout 300)
# exit 0 = answered (stdout = answer), 2 = timeout

配置

环境变量优先，其次为 ~/.config/telegram/config（权限模式 600）：

TELEGRAM_BOT_TOKEN=123:ABC...     # default bot
TELEGRAM_CHAT_ID=987654321        # default target
BOT_ALERTS_TOKEN=456:DEF...       # --bot alerts   (add via: setup --bot alerts)
TARGET_FAMILY=-100987...          # --to family    (any chat/group/channel id)

只接受来自已配置聊天 ID 的回复和答案。

Claude Code hooks（settings.json）

当 Claude 需要输入以及完成任务时，向你的手机发送提醒：

{
  "hooks": {
    "Notification": [{"hooks": [{"type": "command",
      "command": "~/.claude/skills/telegram/scripts/telegram.sh send \"🔔 Claude needs input in $(basename \\\"$PWD\\\")\""}]}],
    "Stop": [{"hooks": [{"type": "command",
      "command": "~/.claude/skills/telegram/scripts/telegram.sh send \"✅ Claude finished in $(basename \\\"$PWD\\\")\" --silent"}]}]
  }
}

在任何脚本/自动化流程中设置审批关卡：

if [ "$(scripts/telegram.sh ask 'Deploy to prod?' --options 'Yes,No')" = "Yes" ]; then
  ./deploy.sh
fi

评论

支持 Markdown