PROJECT INTRO
项目介绍
AWRelay 把用户发给机器人的私聊消息转发到启用了 Topics 的超级群组里,每位用户对应一个独立话题。管理员直接在话题内发消息即可回传给用户。
主要功能
话题式收件箱双向消息回传人机验证广告过滤黑名单限流保护
前置条件
- 一个已开启 Topics 的 Telegram 超级群组
- Bot 已加入群组并具备管理员权限
- 准备好
BOT_TOKEN、ADMIN_ID、GROUP_ID - 如需代理,准备
PROXY_URL
详细搭建方法
- 创建 Telegram Bot,并从
@BotFather获取BOT_TOKEN。 - 准备管理员的 Telegram 数字 ID,填入
ADMIN_ID。 - 创建超级群组并开启 Topics。
- 把 Bot 加入群组并授予管理话题权限。
- 获取群组的
GROUP_ID。 - 编辑
docker-compose.yml,填入BOT_TOKEN、ADMIN_ID、GROUP_ID。 - 如需代理,补充
PROXY_URL。 - 执行
docker compose pull与docker compose up -d。 - 使用
docker compose logs -f查看日志,确认机器人已上线。 - 在群中发送
/menu检查控制面板与过滤规则。
本地运行
- 执行
pip install -r requirements.txt。 - 复制
.env.example为.env。 - 填写
BOT_TOKEN、ADMIN_ID、GROUP_ID。 - 执行
python main.py。
管理指令
/menu:打开控制面板/ban:拉黑对应用户/unban:解除黑名单/cancel:取消当前输入/help:查看帮助