宝塔面板部署 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 的步骤。
宝塔版本：9.3.0
系统版本：Ubuntu 24.04 LTS
Python 版本为系统自带，因为宝塔 Python 项目有问题，从面板安装的 Python 是自签证书，无法连接 QQ 机器人 API，所以不可用。
在面板上打开终端
cd /www/wwwroot
sudo git clone http://github.com/Soulter/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——易于上手的多平台聊天机器人及开发框架