B

TELEGRAM PERSONAL ASSISTANT

让每一次群组变化,都及时被看见。

集中管理 Telegram 群消息、每日摘要、通知机器人和自动签到,让个人工作台更清晰、更可靠。

  • 统一查看监控群组和关注用户
  • 每日摘要与 AI 总结
  • 签到任务与回复确认

欢迎回来

登录管理员账号,继续管理你的 TG-Butler。

忘记管理员密码时,请在服务器运行 bu → 1 网页后台 → 2 管理员账户重置。

BTG-Butler你的 Telegram 管家
工作台
连接与配置
系统
群组监控 · 日报 · 自动签到

YOUR TELEGRAM, ORGANIZED

运行概览

每分钟查看监控、通知、日报和最近执行记录。

加载中
配置和凭据保存后,运行中的任务服务会自动重启并立即生效;已停止的服务会在下次启动时读取新配置。密钥不会回显。Telegram 登录与查群操作会短暂停止任务,结束后恢复。
▦

监控群组

0有选择地关注消息
⌁

签到任务

0发送与成功确认分别记录
◷

日报时间

—
●

任务服务

加载中网页后台独立运行

任务服务

网页后台与任务服务独立运行,停止监控不会关闭本页面。

离线
保持 TG-Butler 最新

更新脚本与依赖,配置、凭据、会话和数据会保留;提交后页面将在 10 秒后自动刷新。

快速入口

从这里继续完成常用配置。

最近执行记录

查看日报与签到任务最近一次的处理结果。

日期类型任务 / 群组结果

Telegram 账号

每个账号有独立登录会话;群组和签到任务可以分别分配。

账号应用凭据

用于登录你的个人 Telegram 账号,读取已加入的群消息、发送签到命令。与通知机器人的 Token 不同。

登录 Telegram 账号

先保存上方应用凭据。验证码由 Telegram 提供,可能发送到已登录的 Telegram 客户端。验证流程 5 分钟内有效。

手机号、验证码及两步验证密码只用于登录。请通过 SSH 隧道或 HTTPS 访问。

导入历史消息

历史导入范围为最近几个完整自然日,不包含今天。默认导入前一天,适合生成测试日报;消息会按消息 ID 去重,最多扫描 5000 条。

群组 ID 请在“群组与关注用户”页查询。

查找群组与用户 ID

输入公开群组链接或用户名,快速获取群组 ID;输入用户 @用户名获取用户 ID。

公开群组链接和用户名需要账号可以访问;私密邀请链接无法直接解析。成员可见范围由群权限决定,匿名发言无法识别隐藏的个人身份。

监控群组

填写账号已加入的群组 ID,并选择关注谁的发言。

筛选开关关闭时,关注-日报机器人发送关注用户的每条消息;开启后,自定义机器人仅发送命中关键词、图片或链接规则的关注消息,并附上原消息。多个条件之间是“或”,关键词可选择任一或全部匹配。

每日日报

汇总前一天的本地消息。默认提供数量统计和消息摘录;配置 AI 后可生成话题总结。

AI 服务密钥

定时签到

按配置时区,每天发送一次指定命令。

群组 ID、签到机器人 ID 可在“Telegram 账号”页查询;命令与回复关键词请以群内机器人的帮助信息为准。同一任务名称每天只尝试一次,修改名称会被视为新任务。测试会真实发送签到命令,但不会占用当天正式签到次数。

运行设置

Docker 部署默认监听 0.0.0.0:15678;HTTPS Cookie 请按 README 中的命令配置。

管理员账户

当前为单管理员模式,网页与 bu 管理同一账户。此账号仅用于后台登录,与 Telegram 账号独立。

通知机器人

关注-日报机器人发送每日日报、签到结果,以及筛选关闭时关注用户的全部消息;自定义机器人在筛选开启且规则命中时发送关注消息,并附上原消息。两个机器人都需要先向它发送 /start。

关注-日报机器人

自定义机器人

要复制原消息(含图片、文件等),请将自定义机器人加入对应来源群组并确保它可以读取消息。升级旧版本时,原有 TG_BOT_TOKEN / TG_NOTIFY_CHAT_ID 会作为两个角色的回退配置;分开配置后即可分别使用。

自动备份计划

每日按运行设置中的时区将备份保存到服务器,最多保留最近 30 份。

读取备份计划中…

备份与恢复

导出备份到本地保存,或从备份恢复配置、通知凭据、Telegram 登录会话和消息记录。

导出文件包含敏感凭据和账号会话,请妥善保管。导入仅接受 20 MB 以内的 TG-Butler .tar.gz 备份,导入前会自动备份当前数据;网页管理员账号与访问设置会保留。

最近备份

定时备份和手动备份保存在服务器 /var/lib/tg-butler/data/backups/;可以下载到本地或从文件恢复。

TG-Butler · 私人 Telegram 工作台凭据与账号会话存储于你的服务器