Skip to content

一、部署安装本项目

Soulter edited this page Dec 3, 2023 · 20 revisions

0. GOCQ和QQ频道SDK是啥?

go-cqhttp(以下简称GOCQ)是由Mrs4s以及多位贡献者维护的一个第三方QQ消息接口(相当于第三方客户端),功能强大,支持QQ、QQ频道的消息接收与发送。本项目使用了GOCQ进行QQ和QQ频道的消息接收与发送。不过由于腾讯频繁的更换协议,目前不太稳定(小部分QQ号会登录失败)。

QQ频道SDK是腾讯QQ频道团队开源的QQ频道消息接口。官方认证,因此很稳定。不过需要申请appid、token(下面有教程)。并且对主动消息有限值。

各有优缺点,可以权衡一下(或者都启用)。

1. 部署项目

Windows部署

前往 https://github.com/Soulter/AstrBotLauncher/releases 下载启动器,然后按照启动器内容进行相关操作。

Linux部署

git clone https://github.com/Soulter/AstrBot.git
cd AstrBot

2. 配置项目

Windows配置

如果您使用了启动器,那么在成功部署完毕之后,目录下面会生成AstrBot/configs/config.yaml这个文件。 然后可以打开这个文件进行配置。(注:配置文件默认启动的是QQ频道SDK平台)

如果您希望使用GOCQ平台,且如果您是第一次使用,请先编辑launcher.exe所在目录下的config.yaml(提醒:不是在go-cqhttp/下,也不是在 AstrBot/configs 下)。编辑此文件内容开头的QQ号和QQ密码然后保存,然后打开go-cqhttp程序。

GOCQ支持QQ和QQ频道两个平台同时运作,如果GOCQ实在用不了,可以用QQ频道SDK,但只支持QQ频道。

关于本项目配置文件的配置:可以参考项目配置文件配置

Linux配置

在成功部署完毕之后,目录下面会生成AstrBot/configs/config.yaml这个文件,然后可以使用vim或其他文本编辑器打开这个文件进行配置。(注:配置文件默认启动的是QQ频道平台)

如果您希望使用GOCQ,需要自行新开窗口(tmux/screen)部署go-cqhttp(链接:go-cqhttp),并且将gocqhttp的配置文件的server部分替换为以下文本:

servers:
  - http:
      host: 127.0.0.1
      version: 0
      port: 5700
      timeout: 5
  - ws:
      address: 127.0.0.1:6700
      middlewares:
        <<: *default

如果只想使用QQ频道的sdk,那么可以不打开gocq。

关于本项目配置文件的配置:可以参考二、项目配置文件配置

3. 运行

Linux

配置好配置文件之后,使用:

python main.py
或者
python3 main.py

Windows

配置好配置文件之后,使用: 直接启动launcher.exe运行

Help Me

开源项目维护不易,欢迎赞助我:)

alipayHelpSoulter wxHelpSoulter