group_assist_bot

KO | EN

gitlite — search

#typescript #llm #go #golang #rust #linux #docker #java #windows #awesome #cli #vue #mcp #ios

group_assist_bot

(★ 95)

让机器人管理你的telegram群组

group_assist_bot 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![image](https://boat.990599.xyz/20250214-telegram_group_assist.png)
![image](https://boat.990599.xyz/20250214-telegram_group_assist1.png)
# 操作说明
```bash
v1.4--带有群组管理面板，可以封禁用户（移除群聊），单用户禁言，群组禁言
v1.5--修复图片、视频等多媒体下载（包含nginx配置文件nginx.conf），筛选
v1.6--轻度禁言，只准发送文本文字，有自动禁言功能
v1.7--查看群员信息
v1.8--入群验证功能
v1.9--垃圾信息检测
v2.0--整合需要用户修改的配置文件
v2.1--修正群组成员列表
v2.2--群组成员列表 不超过主窗口（目前最新版本）
=========py版本，小白可以看下面的docker版本====================================
1. 新建必要的文件夹
mkdir -p /home/tel_group_ass/static/js
mkdir -p /home/tel_group_ass/templates

2. 将必要的文件内容复制下来，并放入对应的文件夹
文件树如下：
/home/tel_group_ass
├── config.py
├── static
│   ├── js
│   │   ├── GroupAdminPanel.js
│   │   ├── GroupMembersPanel.js
│   │   ├── JoinVerificationPanel.js
│   │   ├── messages.js
│   │   └── SpamFilterPanel.js
│   └── login.html
├── telegram-bot.py
└── templates
    └── index.html

或者你也可以直接从github上克隆下来（确保 /home/tel_group_ass 目录在你执行克隆操作前不存在）
git clone https://github.com/Jasonzhang2023/group_assist_bot /home/tel_group_ass

文件都保存好后，记得改属性：
chmod +x /home/tel_group_ass/telegram-bot.py /home/tel_group_ass/static/login.html /home/tel_group_ass/templates/index.html
chmod +x /home/tel_group_ass/static/js/GroupAdminPanel.js /home/tel_group_ass/static/js/messages.js /home/tel_group_ass/static/js/SpamFilterPanel.js /home/tel_group_ass/static/js/JoinVerificationPanel.js
或者你也可以直接从github上克隆下来
这些文件你需要修改的地方有：
config.py（可以看着修改，小白也能看得懂需要修改的地方，我就不赘述了）
其他主体文件就不需要修改，直接用即可。

3. Nginx的配置
因为用了webhook，所以要用反代，nginx的配置文件你可以放到你的nginx的conf文件夹内，nginx内需要修改的地方为：

第4行，你的网址，和config.py中的网址保持一致
第6、7行，证书地址

4. 配置进程保护 telegram_group_assistant.service

touch /etc/systemd/system/telegram_group_assistant.service
nano /etc/systemd/system/telegram_group_assistant.service
填入以下内容：
[Unit]
Description=Telegram Group assistant
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/home/tel_group_ass
ExecStart=/root/venv/bin/python /home/tel_group_ass/telegram-bot.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
5. 配置Python虚拟环境（如果你是高手，也可以不用Python虚拟环境）
步骤 1: 安装虚拟环境支持工具
首先，确保你的系统安装了 python3-venv 包，这允许你创建和管理虚拟环境。

sudo apt update
sudo apt install python3-venv
步骤 2: 创建一个虚拟环境
选择一个目录来创建虚拟环境。例如，你可以在你的用户目录下创建一个名为 venv 的环境：

python3 -m venv ~/venv
步骤 3: 激活虚拟环境
在安装任何包之前，你需要激活虚拟环境：

source ~/venv/bin/activate
要退出虚拟环境：

deactivate
6. 进入虚拟环境，安装必要的工具

source ~/venv/bin/activate
pip install Flask request jsonify session redirect url_for send_file timedelta httpx HTTPXRequest RotatingFileHandler check_password_hash
（如果运行的时候提示缺少工具，那么就pip install 这个工具名字）

7. 确保上面步骤都操作和填写好你的信息后，就可以启动进程了
输入：
sudo systemctl daemon-reload

sudo systemctl enable telegram_group_assistant.service

sudo systemctl start telegram_group_assistant.service

sudo systemctl status telegram_group_assistant.service
8. 你需要将你的机器人加入到群内，并升级为admin管理员，就可以愉快的管理群了。
输入你的网址，会提示你输入密码（config.py中配置好的）后，就能见到操作界面

=========docker版本====================================
1、在服务器上部署：
# 创建必要的目录
mkdir -p /home/docker/telegram-bot/{data,logs}
mkdir -p /home/docker/telegram-bot/data/files
chmod -R 755 /home/docker/telegram-bot

2、下载必要的文件
# 进入文件夹
cd /home/docker/telegram-bot

# 复制配置文件模板,并修改为你的配置信息config.py
wget https://raw.githubusercontent.com/Jasonzhang2023/group_assist_bot/refs/heads/master/docker-config.py -O config.py

# 编辑配置文件（小白都可以看得懂的，请自行修改）
nano config.py

修改必须的几个参数：
TELEGRAM = {
    'BOT_TOKEN': 'YOUR_BOT_TOKEN',  # 替换为你的bot token
    'ADMIN_ID': 123456789,          # 替换为你的管理员ID（整数）
    'WEBHOOK_URL': 'https://your-domain.com/webhook'  # 替换为你的webhook URL
}

'ACCESS_TOKEN': 'your-access-token'          # 替换为你的访问令牌

# 下载 docker-compose.yml
wget https://raw.githubusercontent.com/Jasonzhang2023/group_assist_bot/refs/heads/master/docker-compose.yml

3、 启动服务
docker-compose up -d

4、配置nginx（选择docker-nginx_website.conf 并保存到你的nginx配置文件中）

5、你需要将你的机器人加入到群内，并升级为admin管理员，就可以愉快的管理群了。
输入你的网址，会提示你输入密码（config.py中配置好的）后，就能见到操作界面

group_assist_bot

group_assist_bot 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

group_assist_bot

group_assist_bot 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README