注:本文中Linux系统指令均为Ubuntu使用,centos等请根据指令按系统情况改动。
目录
一、环境配置
二、配置go-cqhttp
三、安装nonebot
四、运行机器人
五、插件
六、最后
1、python版本>=3.8.0。如果版本不对请更新版本,Windows可能需要你卸载原来的版本再安装且配置环境变量但是Linux输入以下指令:
sudo apt-get install python3.8
如果你不确定你当前的Linux系统能安装python3什么版本,请输入上面指令按tab键,如图便可以安装,且需要记住你当前安装的版本号,务必。
2、为了方便管理项目和包,以及后面(可能)创建exe文件,我们需要先构建虚拟环境。我觉得这是开始某个项目的必要前提。虚拟环境我推荐用python原生的就可以,没必要搞那么复杂,原生的也挺好用。
(1)先创建项目文件夹(Windows和Linux一样):
mkdir qqrobot
cd qqrobot
(2)创建虚拟环境:Windows中pythonx=python而Linux中pythonx等于你刚才安装的版本,比如我的python3.8
pythonx -m venv robotven
如果报错且提示未找到vnev包,Linux请输入:
sudo apt-get install python3.8-venv
Windows请输入:
pip install venv
结果如下图:
(3)激活虚拟环境:
Windows
robotven\Scripts\activate
Linux
source robotven/bin/activate
当终端前面带有(robotven) 即为进入成功。如图:
go-cqhttp帮助中心
go-cqhttp下载地址
1、下载文件
从下图中选取合适版本下载:
也可以选取别的版本,不过可能在某些地方和我有些许不同,注意即可。
这里我的Linux下载了go-cqhttp_1.0.0-rc4_linux_amd64.rpm,
Windows下载了go-cqhttp_windows_amd64.exe
Linux需要解压文件,解压完会得到一个usr的文件夹。
2、运行go-cqhttp
Windows直接双击exe文件会生成go-cqhttp.bat,直接双击:
选择3,便会生成文件config.yml
Linux输入:
./usr/bin/go-cqhttp
同样选择3,生成config.yml文件
打开config.yml文件,里面都有注释,你可以参考我的,也可以自己动手改:
# go-cqhttp 默认配置文件
account: # 账号相关
uin: # QQ账号
password: ' ' # 密码为空时使用扫码登录
encrypt: false # 是否开启密码加密
status: 0 # 在线状态 请参考 https://docs.go-cqhttp.org/guide/config.html#在线状态
relogin: # 重连设置
delay: 3 # 首次重连延迟, 单位秒
interval: 3 # 重连间隔
max-times: 0 # 最大重连次数, 0为无限制
# 是否使用服务器下发的新地址进行重连
# 注意, 此设置可能导致在海外服务器上连接情况更差
use-sso-address: true
# 是否允许发送临时会话消息
allow-temp-session: false
heartbeat:
# 心跳频率, 单位秒
# -1 为关闭心跳
interval: 5
message:
# 上报数据类型
# 可选: string,array
post-format: string
# 是否忽略无效的CQ码, 如果为假将原样发送
ignore-invalid-cqcode: false
# 是否强制分片发送消息
# 分片发送将会带来更快的速度
# 但是兼容性会有些问题
force-fragment: false
# 是否将url分片发送
fix-url: false
# 下载图片等请求网络代理
proxy-rewrite: ''
# 是否上报自身消息
report-self-message: false
# 移除服务端的Reply附带的At
remove-reply-at: false
# 为Reply附加更多信息
extra-reply-data: false
# 跳过 Mime 扫描, 忽略错误数据
skip-mime-scan: false
output:
# 日志等级 trace,debug,info,warn,error
log-level: warn
# 日志时效 单位天. 超过这个时间之前的日志将会被自动删除. 设置为 0 表示永久保留.
log-aging: 15
# 是否在每次启动时强制创建全新的文件储存日志. 为 false 的情况下将会在上次启动时创建的日志文件续写
log-force-new: true
# 是否启用日志颜色
log-colorful: true
# 是否启用 DEBUG
debug: false # 开启调试模式
# 默认中间件锚点
default-middlewares: &default
# 访问密钥, 强烈推荐在公网的服务器设置
access-token: ''
# 事件过滤器文件目录
filter: ''
# API限速设置
# 该设置为全局生效
# 原 cqhttp 虽然启用了 rate_limit 后缀, 但是基本没插件适配
# 目前该限速设置为令牌桶算法, 请参考:
# https://baike.baidu.com/item/%E4%BB%A4%E7%89%8C%E6%A1%B6%E7%AE%97%E6%B3%95/6597000?fr=aladdin
rate-limit:
enabled: false # 是否启用限速
frequency: 1 # 令牌回复频率, 单位秒
bucket: 1 # 令牌桶大小
database: # 数据库相关设置
leveldb:
# 是否启用内置leveldb数据库
# 启用将会增加10-20MB的内存占用和一定的磁盘空间
# 关闭将无法使用 撤回 回复 get_msg 等上下文相关功能
enable: true
# 媒体文件缓存, 删除此项则使用缓存文件(旧版行为)
cache:
image: data/image.db
video: data/video.db
# 连接服务列表
servers:
# 添加方式,同一连接方式可添加多个,具体配置说明请查看文档
#- http: # http 通信
#- ws: # 正向 Websocket
#- ws-reverse: # 反向 Websocket
#- pprof: #性能分析服务器
# 反向WS设置
- ws-reverse:
# 反向WS Universal 地址
# 注意 设置了此项地址后下面两项将会被忽略
universal: ws://127.0.0.1:8088/onebot/v11/ws/
# 反向WS API 地址
api: ws://your_websocket_api.server
# 反向WS Event 地址
event: ws://your_websocket_event.server
# 重连间隔 单位毫秒
reconnect-interval: 3000
middlewares:
<<: *default # 引用默认中间件
请留意
# 反向WS Universal 地址
# 注意 设置了此项地址后下面两项将会被忽略
universal: ws://127.0.0.1:8088/onebot/v11/ws/
此部分,其中8088为端口号,可更改,但你需要记住。
配置完后重新运行go-cqhttp:
如果你是第一次登录,则需要验证身份。若终端上能显示你qq实际收到的消息,那即为成功,不必理会那些警告。如图:
1、安装必要库
pip3 install nb-cli pydantic loguru pygtrie httpx python-dotenv uvicorn fastapi requests selenium aiocqhttp ffmpeg aiohttp
pip3 install nonebot2 nonebot-plugin-apscheduler nonebot-adapter-cqhttp
如果下载速度缓慢,请加上换源指令,此为清华源:
-i https://pypi.tuna.tsinghua.edu.cn/simple/
若出现:Command "python setup.py egg_info" failed with error code 1 in /tmp/pip-build-gp_zyhu4/watchfiles/
请输入:
pip install --upgrade pip
2、创建项目
输入:nb create
选择simple,回车;
项目名称自取,我取nonebot2,回车;
用鼠标选取FastAPI驱动器和HTTPX驱动器,回车;
用鼠标选择OneBot V11,回车;
选择src文件夹,回车;
选择安装依赖,回车;
选择不创建虚拟环境,回车;
终端输入(nonebot2是你的项目名称):
cd nonebot2
nb run
若出现如下:
则成功。
若出现:fastapi.exceptions.FastAPIError: Invalid args for response field! Hint: check that
请在终端输入:
pip install fastapi==0.88.0
Linux按住CRT+H显示隐藏文件,Windows请寻找设置-显示隐藏文件。
打开.env,将其修改为如下:
ENVIRONMENT=prod
打开.env.prod,将以下内容替换:
HOST=127.0.0.1
PORT=8088
其中PORT为前面要求你记住的端口号,可自行更改。
请记住,你现在使用的是.env.prod作为机器人的配置文件而不是.env.dev!!!
自此,你已经可以开始为你的机器人开启拓展。
切换至你的项目根目录下,注意是项目根目录而不是nb项目根目录。
运行go-cqhhtp。
打开新的终端,激活虚拟环境,切换至nb项目根目录下,终端输入:nb run
你的终端应当至少出现:
[INFO] nonebot | Current Env: prod
[INFO] nonebot | OneBot V11 | Bot 你的QQ号 connected
[INFO] websockets | connection open
三行文字,因为这代表着成功。
期望的情况是,你的终端能收到你的QQ实际收到的消息,包括文字、图片(链接)等。
nonebot帮助文档
请打开上述链接,里面有关于nonebot2的大部分指南。
如果你想方便快捷的使用机器人,那么你可以打开:
nonebot插件商店
复制想要安装的插件命令,在你的已经激活虚拟环境的终端下输入,再重新运行你的nb run。同时请注意插件右上角的GitHub图标,那是这个插件的开源项目网址
这个插件的运行指令即配置理应在README.md有被提及,请注意观察。
同时请注意,你使用的是.env.prod文件,你的插件配置理应在此配置。
插件商店的功能多种多样,不过有些需要额外的账号及配置,请在安装之前留意。
安装插件的指令:
nb plugin install 插件名
查询可用插件:
nb plugin list
卸载插件的指令:
nb plugin uninstall 插件名
如果你遇见:sudo: netstat:找不到命令的解决办法
请输入:
sudo apt-get install net-tools
如果你无法关闭正在运行的nb项目,请按住CRT+C 再按住CRT+Z。
如果你因此遇见OSError: [Errno 98] Address already in use
请输入:
sudo netstat -tunlp
在输出中找到占用你端口号的进程,如图:
使用:
kill -9 8713
重新运行 nb run即可。