目 录CONTENT

文章目录

通过AstrBot搭建一站式 Agentic 聊天机器人平台

qiushengcai
2025-10-08 / 0 评论 / 1 点赞 / 22 阅读 / 0 字

AstrBot项目源码地址:https://github.com/AstrBotDevs/AstrBot

AstrBot官方文档:https://docs.astrbot.app/what-is-astrbot.html

NapCatQQ项目源码地址:https://github.com/NapNeko/NapCatQQ

NapCatQQ官方文档:https://napcat.napneko.icu/guide/start-install

一、准备条件

1.一台电脑最好是云服务器,可以长期运行系统Ubuntu 22以上,Windows系统也可以部署但是不好用。

二·、运行环境安装

改项目依赖于Python,并且版本大于3.10

1. Python运行环境

有些云服务系统默认安装了Python

python3 --version

如果出现的是版本号并且大于3.10就可以不用安装了,没有出现版本号就要安装。

更新系统包列表

sudo apt update

安装 Python 3

sudo apt install python3 -y

安装 pip

apt install python3-pip

2.安装UV管理依赖

pip install uv

三、AstrBot项目部署

本次采用手动部署方式,不使用任何第三方的平台部署。

1.获取项目源码

通过Git获取

git clone https://github.com/AstrBotDevs/AstrBot && cd AstrBot

这一步已经进入到了AstrBot 目录下

在AstrBot 目录下安装项目的所有依赖

uv sync

2.后台运行项目

下面指令都在AstrBot 目录下执行

cd /root/AstrBot

后台编译运行项目

nohup uv run main.py > output.log 2>&1 &

执行成功后会输出一个进程ID

接下来我们查看日志试试输出

tail -f output.log

运行成功的话会输出一些信息,里面有初始的用户密码,WebUI的地址。

Snipaste_2025-10-08_14-39-26.png

停止后台进程

pkill -f main.py

3.进入WebUI管理界面

在浏览器输入电脑的IP和端口进入,如果实在具有公网IP的服务器上部署的一定要重新设置用户名和密码。

Snipaste_2025-10-08_14-49-03.png

四、消息平台部署

消息平台可以接入很多个我们接下来接入QQ个人号

1.NapCatQQ安装部署

通用安装,安装过程全部默认即可

curl -o \
napcat.sh \
https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh \
&& bash napcat.sh

出现下面界面及安装完成

Snipaste_2025-10-08_15-18-30.png

使用TUI-CLI 工具启动napcat

napcat 

2.修改配置登录QQ

接下来就是使用界面配置和登录QQ的过程,登录过程需要进行扫码。

在配置里面开启开机自动启动和WebUI,配置时要设置登录的token。

Snipaste_2025-10-08_15-26-58.png

Snipaste_2025-10-08_15-46-46.png

出现下面界面及配置完成

Snipaste_2025-10-08_15-30-21.png

通过IP加端口6099方式访问WebUI

Snipaste_2025-10-08_15-47-17.png

3.配置WebSocket客户端

新建WebSocket客户端

Snipaste_2025-10-08_15-50-00.png

配置参数

选择启用

名称自定义一个

URL填写 ws://localhost:6199/ws

Token自定义一个,记住后面配置AstrBot要用

Snipaste_2025-10-08_15-51-31.png

4.AstrBot添加消息平台

添加消息平台,选择QQ个人号

Snipaste_2025-10-08_16-15-41.png

填写配置

名称自定义

启用选择

主机地址一般默认0.0.0.0

端口号6199,上一步配置的端口号

token填写上一步配置的

Snipaste_2025-10-08_16-15-55.png

点击保存

5.验证是否配置成功

前往 AstrBot WebUI 控制台,如果出现 aiocqhttp(OneBot v11) 适配器已连接。 相关蓝色的日志,说明连接成功。

此时,你的 AstrBot 和 NapCatQQ 应该已经连接成功。使用 私聊 的方式在 QQ 对机器人发送 /help 以检查是否连接成功。

1

评论区