用途：让 Claude 智能体充当 Telegram 机器人，管理账号、发送消息并自动化 Telegram 交互，采用基于名称的自然联系人系统。
主要能力：创建并配置机器人；导入、添加、查询、删除联系人；按名称或 chat ID 发送文本消息，支持 markdown/html 格式、按钮、文件与图片；获取机器人和聊天信息；加入群组或频道；将自然语言请求转换为联系人命令。
使用方式：先安装依赖 pip install python-telegram-bot python-dotenv。通过 @BotFather 的 /newbot 创建机器人并保存 API token，运行 python scripts/init_bot.py 生成 .env，再用 python scripts/test_connection.py 验证。建议尽早运行 python scripts/contacts.py import 导入联系人。发送消息示例：python scripts/send_message.py --to "John" -m "Hey, how are you?"；带格式：--format markdown 或 html；按钮：python scripts/send_with_buttons.py --to "John" -m "Choose option" --buttons "Yes,No,Maybe"；文件与图片：send_file.py、send_photo.py。配置存放在 .env（TELEGRAM_BOT_TOKEN、DEFAULT_CHAT_ID），联系人存于 contacts.json。
适用场景：需要以自然名称向个人或群组发消息、通知团队、自动化 Telegram 交互的智能体工作流。
限制：群聊中机器人默认仅接收以 / 开头的命令、对机器人消息的回复或 @提及，需通过 @BotFather 关闭隐私模式；Telegram 限制约 30 条消息/秒，脚本含基础限流；群组 ID 为负数，由联系人系统处理；需先让用户给机器人发消息或将其加入群组才能导入联系人；切勿提交 .env 与 contacts.json，勿分享 token。