Telegram反骚扰双向聊天机器人

📋 完整部署步骤

第一步：准备工作

1. 获取 Telegram Bot Token

• 在 Telegram 中搜索并打开 @BotFather
• 发送 /newbot 命令
• 按提示输入机器人的显示名称（例如：我的客服机器人）
• 输入机器人的用户名（必须以 bot 结尾，例如：my_service_bot）
• 复制获得的 Bot Token（格式类似：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

2. 创建话题群组（Forum Group）

• 在 Telegram 中创建一个新的超级群组（Supergroup）
• 进入群组设置 → 点击"群组类型" → 启用"话题"功能
• 将你的 Bot 添加到群组中
• 给 Bot 授予管理员权限，至少包括：
  • ✅ 发送消息
  • ✅ 删除消息
  • ✅ 管理话题
  • ✅ 固定消息

3. 获取群组 ID

• 将 @GetMyChatID_Bot 添加到你的话题群组
• 它会自动发送群组 ID（格式类似：-1001234567890，注意是负数）
• 记录这个 ID，稍后配置时需要用到

4. 获取管理员 ID

• 在 Telegram 中搜索并打开 @userinfobot
• 点击"开始"，它会显示你的用户 ID（纯数字，例如：123456789）
• 如果有多个管理员，分别获取他们的 ID

5. （可选）获取 Gemini API 密钥

• 访问 Google AI Studio
• 登录 Google 账号
• 点击 "Create API Key"
• 复制生成的 API 密钥

---

第二步：安装部署

方法一：直接运行（推荐新手）

1. 克隆项目

bash
git clone https://github.com/Hamster-Prime/Telegram_Anti-harassment_two-way_chatbot.git
cd Telegram_Anti-harassment_two-way_chatbot

2. 创建 Python 虚拟环境

bash
# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Linux/Mac 用户：
source venv/bin/activate

# Windows 用户：
venv\Scripts\activate

3. 安装依赖

bash
pip install -r requirements.txt

4. 配置环境变量

bash
# 复制配置模板
cp .env.example .env

# 编辑 .env 文件
# Linux/Mac 用户可以用：
nano .env

# Windows 用户可以用记事本打开：
notepad .env

5. 填写配置文件（.env）

必填项：

env
BOT_TOKEN=你的Bot_Token
FORUM_GROUP_ID=-1001234567890  # 你的话题群组ID
ADMIN_IDS=123456789,987654321  # 管理员ID，多个用逗号分隔

可选项（启用 AI 功能时需要）：

env
GEMINI_API_KEY=你的Gemini_API密钥
ENABLE_AI_FILTER=true
VERIFICATION_ENABLED=true
AUTO_UNBLOCK_ENABLED=true

其他可选配置：

env
DATABASE_PATH=./data/bot.db
MAX_WORKERS=5

6. 运行机器人

bash
python bot.py

看到类似 Bot started successfully! 的提示就说明启动成功了。

---

方法二：使用 Docker（推荐有经验用户）

1. 克隆项目

bash
git clone https://github.com/Hamster-Prime/Telegram_Anti-harassment_two-way_chatbot.git
cd Telegram_Anti-harassment_two-way_chatbot

2. 配置 .env 文件

bash
cp .env.example .env
# 编辑 .env，填入实际配置（同上）
nano .env

3. 构建 Docker 镜像

bash
docker build -t telegram-bot .

4. 运行容器

bash
docker run -d --name telegram-bot-container --env-file .env telegram-bot

5. 查看运行状态

bash
# 查看日志
docker logs -f telegram-bot-container

# 停止容器
docker stop telegram-bot-container

# 重启容器
docker restart telegram-bot-container

---

第三步：测试功能

1. 测试用户端

• 用一个普通 Telegram 账号向你的 Bot 发送 /start
• 如果启用了人机验证，会收到验证问题
• 回答正确后，发送一条测试消息（例如："你好"）

2. 检查管理端

• 在你的话题群组中，应该能看到为该用户创建的新话题
• 话题标题会显示用户信息（头像、名称、ID、用户名）
• 用户的消息会出现在对应话题中

3. 测试回复

• 在话题中直接回复用户的消息
• 用户应该能收到你的回复

4. 测试管理命令

在话题群组中测试以下管理员命令：

/blacklist - 查看黑名单
/stats - 查看统计信息
/block 用户ID 拉黑原因 - 拉黑用户

---

第四步：维护和监控

1. 查看日志

bash
# 如果直接运行
tail -f logs/bot.log  # 如果有日志文件

# 如果用 Docker
docker logs -f telegram-bot-container

2. 备份数据库

bash
# 数据库默认位置：./data/bot.db
cp ./data/bot.db ./data/bot.db.backup

3. 更新代码

bash
git pull origin main
pip install -r requirements.txt --upgrade
# 重启 Bot

---

🎯 核心功能说明

1. 话题自动管理

• 每个用户会自动创建独立话题
• 话题标题显示用户完整信息
• 消息自动归类到对应话题

2. 人机验证（可选）

• 首次消息需通过 AI 生成的验证问题
• 防止机器人批量骚扰
• 验证通过后消息才转发给管理员

3. 黑名单系统

• 管理员可拉黑骚扰用户
• 被拉黑用户会收到提示
• 支持 AI 生成解封问题，回答正确自动解封

4. 多媒体支持

• 支持转发图片、视频、音频、文档
• 保持 Markdown 格式
• 自动处理各种消息类型

---

⚠️ 常见问题

Bot 无法启动

• 检查 Bot Token 是否正确
• 确认 Python 版本 >= 3.10
• 查看是否有防火墙限制

消息无法转发

• 确认 Bot 在群组中有管理员权限
• 检查群组 ID 是否正确（注意负号）
• 验证用户是否被拉黑

AI 功能不工作

• 确认 Gemini API Key 是否有效
• 检查 API 配额是否用完
• 验证网络能否访问 Google API

---

📞 获取帮助

• 项目作者：Sanite&Ava
• GitHub Issues：提交问题到项目仓库

按照以上步骤操作，你应该能成功部署这个 Telegram 双向聊天机器人了！如果遇到具体问题，可以告诉我详细情况，我会帮你解决。