ZeroBot-Plugin 机器人搭建

发表于 更新于 分类于

记录了7月20日下午基于gocqzbp项目搭建的 ZeroBot QQ 机器人的过程。

动机

  1. 之前的业务迫切需要。先前尝试过酷 Q 机器人，但是之前没拿来做什么、没用上几分钟号就被封了；看着 Fusion APP 官方群中的智能群管很是羡慕；
  2. 先前想尝试过使用 GitHub 上的开源框架做一个机器人。第三方的东西毕竟不敢 100% 保证里面没啥，而且搭好一个功能可以被轻易修改的机器人才是我想要的；
  3. 新生群内，有 op 发了个机器人项目的链接，希望搭一个能抽原神十连的机器人，顺便给了 Bot 的项目地址。聊天记录

先决条件

正如 ZeroBot-Plugin 项目介绍中说的，在没有经验的情况下直接前往 gocqzbp 的 Release 页面下载单一可执行文件。

ZeroBot-Plugin readme

跳转至 gocqzbp 官网，其对项目的介绍为“基于 Mirai 以及 MiraiGo 的 OneBot Golang 原生实现，同时融合了ZeroBot-Plugin”。下载最新Release版

gocqzbp-Release

其中，资源Assets中有许多后缀。他们适用的平台如下：

  • 如果您是在家用电脑(Windows环境): windows_amd64
  • 如果您是 x64 Linux 平台 如各种云服务器: linux_amd64
  • 如果您是 armv6 Linux 平台 如树莓派 zero W: armv6
  • 如果您是 MacOS(Darwin平台): darwin

部署流程

下载 gocqzbp Release版本的单一可执行文件后解压：

gocqzbp文件树

在命令行中打开gocqzbp.exe

cmd打开gocqzbp输2

输入2（即选择2: 正向 Websocket 通信），此时文件夹内会生成若干个文件，修改config.yml中account内的uin和password、修改servers.ws.address为127.0.0.1:6700：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
# go-cqhttp 默认配置文件

account: # 账号相关
  uin: 1233456 # 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:
      # 正向WS服务器监听地址
      address: 0.0.0.0:8080
      middlewares:
        <<: *default # 引用默认中间件

这就结束了对机器人的配置。再次打开gocqzbp.exe，登录账号即可。剩下按ZeroBot使用说明继续即可。

成果展示

成果展示

避坑指南

第一次搭建 Bot 有很多不懂的地方。所以，要避坑的地方就是直接跟着ZeroBot-Plugin 的项目介绍，下载该项目的 releases 版本直接运行后报如下错：

zbp.exe报错

这是因为下载到的只是 ZeroBot-Plugin 而不包含 cqhttp。如追求简单省事，直接下载 gocqzbp 即可， gocqzbp 中包含了 go 实现的 cqhttp 和 ZeroBot-Plugin。

有用的资源