AstrBot部署
这里建议安装服务器面板,如btpanel、1panel等,方便管理服务器,以下拿1panel为例
1panel的安装请参考1panel安装,1panel安装过程中没装docker会提示安装docker,可以在1panel安装过程中直接安装docker
这里安装完毕后去服务器提供商放行1panel的端口,之后也是放行astrbot的端口和napcat的端口,放行后就可以在浏览器访问这些了
偷懒的话可以在ssh远程执行以下命令安装1panel
# 非root用户安装的话前面加sudobash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"一定要记住1panel的登录账号密码,后续会用到,否则无法登录1panel界面到时候回ssh改密码就很苦逼了
上方是1panel的主界面,点击docker图标可以查看docker容器

这里可以查看docker容器的详细信息,有几个容器,每个容器的状态,每个容器的端口映射等信息
点击图示的创建按钮可以创建一个新的docker容器
这里点命令输入以下命令可以创建一个新的docker容器(咱为什么不在终端输入呢?)
或者你在创建docker容器时名称随便取,镜像输入soulter/astrbot
,暴露端口6185→6185,6199→6199,网络选择bridge或别的,但如果你要接入napcat的话一定要保证服务器的网络一样,否则连不上
mkdir astrbotcd astrbotsudo docker run -itd -p 6185:6185 -p 6199:6199 -v $PWD/data:/AstrBot/data -v /etc/localtime:/etc/localtime:ro -v /etc/timezone:/etc/timezone:ro --name astrbot soulter/astrbot:latest此时就成功创建了一个新的docker容器,名字叫astrbot,镜像是soulter/astrbot
注意如果你是部署的v4.24.3及以下的版本,默认和账户密码是astrbot 如果你是部署的v4.24.4及以上的版本,默认账户是astrbot,密码是随机生成的,去日志看,第一次登录需要使用默认账户和密码登录,登录后会提示你修改密码,修改后就可以使用新的账户密码登录了
日志的密码位置如下文所示: [00:27:40.590] [Core] [INFO] [dashboard.server:523]: ✨✨✨
AstrBot v4.24.3 WebUI is ready
➜ Local: http://localhost:6185
➜ Initial username: astrbot
➜ Initial password: U*****************y
➜ Change it after logging in ✨✨✨ Set dashboard.host in data/cmd_config.json to enable remote access.
其中的Initial password: U*****************y就是默认密码,登录后记得修改密码哦
astrbot的web界面配置
访问:http://<服务器IP>:6185/#/providers,是你的AI模型提供商,不会整?看下图

这里拿DeepSeek为例,其他的模型提供商配置方法类似,按照提示输入相关信息就可以了

这里的模型提供商地址是DeepSeek的地址,端口是DeepSeek的端口,API Key是DeepSeek的API Key,其他的模型提供商也是一样的,按照提示输入相关信息就可以了
如果你想用的AIAPI提供商不在列表里但官方兼容OpenAI格式,可以选择OpenAI Compatible,输入key再把base url改成你想用的AIAPI提供商的地址和端口就可以了
例如你想用的AIAPI提供商是xiaomi mimo,那就改成https://api.xiaomimimo.com/v1 ,其他同理
bot部署
这里的bot部署是指部署到消息平台的bot,主要是指部署到QQ、微信、钉钉等平台的bot,以下以onebot v11协议的QQ为例
onebot协议的QQ bot部署(napcat)
napcat部署并配置
还记得上面我提的docker部署吗,这里派上用处了
新建一个docker容器,名字叫napcat,镜像输入mlikiowa/napcat-docker
这里访问http://<服务器IP>:6099就可以访问napcat的web界面了
密钥逻辑和astrbot一样,去翻日志
然后登陆QQ,拿你bot的号扫web上的二维码登录,登录成功后就可以在napcat的web界面看到你的QQ了
napcat接入astrbot
这里访问http://<服务器IP>:6099/webui/network,点击添加网络,选择Websocket客户端,输入以下信息
- 名称:随便取
- 地址:ws://<astrbot镜像所在IP>:6199/ws
这里镜像所在IP指网路中的IP地址,不是服务器的IP地址,怎么查看呢?在1panel的docker容器里找到astrbot容器,点击进去就可以看到镜像IP地址了
Token复制一下
- 心跳间隔:10s(1000)
- 重连间隔:10s(1000)
astrbot接入napcat
访问http://<服务器IP>:6185/#/platforms选择OneBot v11,输入以下信息
- 名称:随便取
- 反向 Websocket地址(不用改):0.0.0.0
- 反向 Websocket 端口:6199
- 反向 Websocket Token:粘贴一下napcat的token
- 其他的保持默认,保存后就可以了
测试一下
astrbot和napcat启用后,napcat的猫猫日志里会显示连接成功,astrbot的日志里也会显示连接成功,这时候你就可以在QQ上测试一下了,发送消息到bot号看看能不能收到回复,如果能收到回复说明部署成功了,如果收不到回复说明哪里配置错了,检查一下配置吧(建议发help)
这里的bot部署只是以onebot v11协议的QQ为例,其他平台的bot部署方法类似,按照提示输入相关信息就可以了,其他平台的bot部署方法后续会更新到这篇文章里,敬请期待
另外,compasser(某头猫鱼龙)不兼容(雾),消息会被compasser吃掉,所以不建议使用compasser