Telegram 防骚扰双向聊天机器人 - AI 驱动 开源免费
本帖最后由 Sanite_Ava 于 2025-11-16 11:24 编辑# 🛡️ Telegram 防骚扰双向聊天机器人 - AI 驱动 开源免费
一个功能强大且易于部署的 Telegram 双向聊天机器人。
如果你正在寻找一个方案来管理用户沟通、同时有效防止机器人骚扰，那么这个项目可能正是你需要的！
---
### ✨ **项目亮点**
* 🤖 **AI 智能过滤**: 集成 Google Gemini，自动识别垃圾信息和恶意内容。
* 🛡️ **人机验证**: 新用户必须通过 AI 生成的验证问题，彻底告别机器人骚扰。
* 💬 **独立话题沟通**: 每个用户都在独立的 Telegram 话题 (Forum) 中进行对话，管理一目了然。
* ⚫ **自助解封**: 用户被拉黑后，可以通过回答 AI 问题来自助解封，减轻管理员负担。
* 🖼️ **多媒体支持**: 完美转发图片、视频、文件，并保留 Markdown 格式。
* ⚡ **高性能**：异步架构，轻松应对大量消息，不卡顿。
---
### 🚀 **快速部署**
部署超级简单，只需要两步：
**1. 创建并编辑配置文件 ` .env `**
在一个空目录中创建一个 `.env` 文件，填入你的 Bot Token 等信息。
```env
# --- 必需配置 ---
# Telegram Bot配置
# 从 @BotFather 获取您的 Bot Token
BOT_TOKEN=your_bot_token_here
# 您的Telegram话题群组ID
# 将机器人设为群组管理员后，在群组里发送 /getid ，机器人会自动回复群组ID
FORUM_GROUP_ID=-1001234567890
# 管理员ID（您的Telegram用户ID），多个ID用逗号分隔
ADMIN_IDS=123456789,987654321
# --- 可选配置 ---
# Gemini API配置 (如果您需要使用AI相关功能)
# 从 Google AI Studio 获取
GEMINI_API_KEY=your_gemini_api_key_here
# 是否启用AI自动识别垃圾信息和恶意内容
ENABLE_AI_FILTER=true
# AI判断的置信度阈值（0-100），高于此值才会被认为是恶意内容
AI_CONFIDENCE_THRESHOLD=70
# --- 功能开关 ---
# 是否启用新用户人机验证
VERIFICATION_ENABLED=true
# 是否启用黑名单用户自动解封机制
AUTO_UNBLOCK_ENABLED=true
# --- 数据库配置 ---
# 容器内路径，通常不需要修改
DATABASE_PATH=./data/bot.db
# --- 性能配置 ---
# 消息队列处理的worker数量
MAX_WORKERS=5
# 队列中消息的超时时间（秒）
QUEUE_TIMEOUT=30
# --- 验证配置 ---
# 人机验证的超时时间（秒）
VERIFICATION_TIMEOUT=300
# 用户最大尝试验证次数
MAX_VERIFICATION_ATTEMPTS=3
# --- 速率限制 ---
# 通常不需要修改
# Bot每秒最大处理消息数
MAX_MESSAGES_PER_SECOND=30
# Bot每分钟在群组中最大发送消息数
MAX_GROUP_MESSAGES_PER_MINUTE=20
```
**2. 一行命令启动**
```bash
docker run -d \
--name tg-antiharassment-bot \
-v $(pwd)/.env:/app/.env \
-v $(pwd)/data:/app/data \
--restart unless-stopped \
weijiaqaq/tg-antiharassment-bot:latest
```
搞定！你的机器人现在已经在线运行了。
---
## 📖 使用指南
### 🔑 获取必要信息
1.**Bot Token**: 在 Telegram 中与 [@BotFather](https://t.me/BotFather) 对话，使用 `/newbot` 命令创建机器人即可获得。
2.**话题群组 ID**: 创建一个超级群组 (Supergroup)，在设置中启用“话题”(Topics) 功能。然后将您的机器人添加为该群组的管理员。在群组中发送/getid，机器人会自动回复包含群组 ID 的信息。
3.**Gemini API 密钥** (可选): 访问 (https://aistudio.google.com/api-keys) 创建并复制您的 API 密钥。
### 📜 命令列表
#### 用户命令
- `/start` - 启动机器人，显示欢迎信息。
- `/getid` - 显示当前用户/群组ID。
- `/help` - 显示帮助信息。
#### 管理员命令
- `/block` - 对应话题直接发送永久拉黑用户。
- `/blacklist` - 查看当前的黑名单列表。
- `/stats` - 查看机器人运行统计信息。
### 🔗 **项目链接**
* **GitHub 仓库 (欢迎 Star ⭐):** (https://github.com/Hamster-Prime/Telegram_Anti-harassment_two-way_chatbot)
* **Docker Hub 镜像:** (https://hub.docker.com/r/weijiaqaq/tg-antiharassment-bot)
项目完全开源，欢迎大家试用、提建议或者贡献代码！ 倒是最近有很多广告发到了机器人上面， 这个是近期的痛点 wuchai111 发表于 2025-11-16 11:27
倒是最近有很多广告发到了机器人上面， 这个是近期的痛点
就是最近很多广告 看了下在用的bot也没更新 就自己搓了一个{tieba11} 帮顶，简直是好东西！ nyarime 发表于 2025-11-16 11:52
帮顶，简直是好东西！
{tieba26} 厉害！ RyanZ 发表于 2025-11-16 11:54
厉害！
{tieba25} 厉害了 nyarime 发表于 2025-11-16 11:52
帮顶，简直是好东西！
{tieba8} 感谢分享 这个防得住广告爆破吗{tieba22} 什么时候出cf workers版本的教程就好了，cfkr还是稳定点 好厉害！！！感谢分享
页:
[1]