用途：把更新、告警和文件推送到 Telegram，读取回复，并运行“提问—等待回答”的审批流程，可在手机上完成确认。实现为纯 bash + curl + jq，除 bot token 外无需额外安装。
主要能力：发送文本消息（支持静默、MarkdownV2 格式，失败回退纯文本）、发送文件（自动识别照片）、读取自上次读取以来的新消息、用内联按钮提问并等待回答。
使用方式：首次运行 scripts/telegram.sh setup 进行引导式 BotFather 配置。常用命令：scripts/telegram.sh send "Deploy finished ✅"；send "low priority" --silent；send "bold alert" --format md；send "hi" --to alerts --bot work；file report.pdf "Q3 report"；read；ANSWER=$(scripts/telegram.sh ask "Deploy to prod?" --options "Yes,No" --timeout 300)，退出码 0 表示已回答（stdout 为答案），2 表示超时。
配置：环境变量优先，其次为 ~/.config/telegram/config（权限 600）。可设置 TELEGRAM_BOT_TOKEN、TELEGRAM_CHAT_ID，以及命名 bot（如 BOT_ALERTS_TOKEN 配合 --bot alerts）和命名目标（如 TARGET_FAMILY 配合 --to family，可为任意聊天/群组/频道 id）。
集成：可在 Claude Code 的 settings.json 中配置 Notification 与 Stop 钩子，在需要输入和任务完成时向手机发送提醒；也可在任意脚本或自动化中用作审批门。
限制：回复与答案仅接受来自已配置聊天 ID 的消息。资料未提供其他平台支持、收费或价格信息。