宝塔面板部署 QQ 机器人 AstrBot
AstrBot 是一个聊天机器人及开发框架，作者为 Soulter ，最初的名称是 QQChannelChatGPT，主要用于将 QQ 频道机器人接入 ChatGPT。自2023年12月27日起，改名为 AstrBot。截至本文发布时，AstrBot 已经更新到 3.4.0 预发布版，支持将 QQ 群、QQ 频道、微信、Telegram 等多平台机器人接入 Gemini、GPT、Llama、Claude、DeepSeek、GLM 等各种大语言模型。
宝塔面板是一款服务器管理软件，发布 8 年来，已经逐步成为国内最广泛使用的服务器管理工具。
本文旨在记录在宝塔面板上部署 QQ 机器人 AstrBot 的步骤。
2026年6月26日更新：系统版本和宝塔版本都已经迭代了，更新一下步骤：
宝塔版本：11.8.0 系统版本：Ubuntu 26.04 LTS Python 版本：3.14.4
在面板上打开终端
cd /www/wwwroot/你的域名（可选）
sudo git clone https://github.com/AstrBotDevs/AstrBot
执行完毕后，关闭终端，在面板上点击 网站 —— Python项目 —— 创建虚拟环境，名称可以随便写字母或者数字，我这里使用 venv，环境来源 选择 Python 3.14.4，备注留空，点击 创建。
创建完成后，关闭浮层，在面板上点击添加项目：
- 项目名称 AstrBot
- Python环境 选择刚才创建的 venv
- 项目路径 /www/wwwroot/你的域名（可选）/AstrBot
- 项目执行文件 /www/wwwroot/你的域名（可选）/AstrBot/main.py
- 执行命令 python3 main.py
- 环境变量选择 无，启动用户 选择 root
- 自动填写的 安装依赖包路径 一定要先删除，再点击 确定。
宝塔 Python 项目时隔两年依然有问题，不删除会在安装依赖的过程中卡死，无法创建项目环境。原因是安装依赖的时候， ＞＝某个版本的依赖，宝塔会按照最低版本去安装，即使目前已有更高版本，依然会安装低版本。
- 点击 终端，执行
python3 -m pip install -r requirements.txt。 - 在面板上启动项目。
- 点击 终端 右侧的 设置，勾选 开机启动。
- 在 域名管理 中绑定域名，在 外网映射 中开启 外网映射，点击下方文字即可一键放行页面上的端口，并配置代理路由。
以下分割线内是2024年12月15日的旧版流程，无需阅读。
宝塔版本：9.3.0 系统版本：Ubuntu 24.04 LTS Python 版本：3.12
宝塔 Python 项目有问题，从面板安装的 Python 是自签证书，无法连接 QQ 机器人 API，所以不可用。
在面板上打开终端
cd /www/wwwroot
sudo git clone http://github.com/AstrBotDevs/AstrBot
cd AstrBot
sudo python3 -m venv ./venv
source venv/bin/activate
python3 -m pip install -r requirements.txt
python3 main.py
至此，项目已经安装并成功启动，可关闭终端。
为方便管理，在面板上建立网站项目：
- 点击 网站——其他项目——添加通用项目
- 项目名称 AstrBot
- 项目执行文件 /www/wwwroot/AstrBot/main.py
- 项目端口 6185
- 执行命令 ./venv/bin/python3 main.py
- 运行用户 root
- 勾选设置开机启动，其他保持默认，保存项目。
在面板上启动项目，放行端口 6185，访问 http://服务器IP:6185 即可登录机器人后台。如果觉得输入 IP 和端口不方便，也可以从面板上点击项目名称或者设置，打开端口映射，然后绑定域名，还可以开启SSL。
通过管理后台，用户可配置机器人和大模型服务提供商。
参考资料：AstrBot——易于上手的多平台聊天机器人及开发框架