系统版本:Ubuntu 20.04
SSH工具:Final shell
1.下载MCL Installer
去Github的MCL Installer项目下载适合自己系统的MCL安装文件,然后通过Final shell,在服务器上新建文件夹,把刚下载的MCL Installer文件上传到此文件夹中。
2.运行MCL Installer
首先通过cd命令进入新建的文件夹,然后运行上传的安装文件,我新建的文件夹是mirai
进入文件夹
cd /mirai
运行MCL安装文件
./mcl-installer-1.0.3-linux-amd64
此时即会开始安装Mirai 控制台,安装过程中会询问需要安装的依赖,如无特殊需求,直接按Enter键即可,安装完成会显示 Press Enter to exit.如下图所示
3.安装官方插件
刚刚装好的 Mirai Console 是没有任何功能的。功能将由插件提供。
Mirai 官方提供两个插件:
- chat-command: 允许在聊天环境通过以 "/" 起始的消息执行指令
- mirai-api-http:提供 HTTP 支持,允许使用其他编程语言的插件
去这两个网站下载jar包,然后上传到mirai文件夹下的plugins文件夹中
https://github.com/project-mirai/chat-command/releases
https://github.com/project-mirai/mirai-api-http/releases/tag/v2.4.0
或者使用网站的命令安装也可。
上传好这两个插件,然后运行一次 Mirai Console,再关闭 Mirai Console,此时会在/mirai/config/net.mamoe.mirai-api-http文件夹下生成配置文件,更改配置文件,开启Websocket
## 配置文件中的值,全为默认值
## 启用的 adapter, 内置有 http, ws, reverse-ws, webhook
adapters:
- http
- ws
## 是否开启认证流程, 若为 true 则建立连接时需要验证 verifyKey
## 建议公网连接时开启
enableVerify: true
verifyKey: 123456
## 开启一些调式信息
debug: false
## 是否开启单 session 模式, 若为 true,则自动创建 session 绑定 console 中登录的 bot
## 开启后,接口中任何 sessionKey 不需要传递参数
## 若 console 中有多个 bot 登录,则行为未定义
## 确保 console 中只有一个 bot 登陆时启用
singleMode: false
## 历史消息的缓存大小
## 同时,也是 http adapter 的消息队列容量
cacheSize: 4096
## adapter 的单独配置,键名与 adapters 项配置相同
adapterSettings:
## 详情看 http adapter 使用说明 配置
http:
host: localhost
port: 8080
cors: [*]
## 详情看 websocket adapter 使用说明 配置
ws:
host: localhost
port: 8080
reservedSyncId: -1
4.登录机器人账号
首先在安装文件夹启动Mirai 控制台
启动Mirai
./mcl
或者
sh mcl
当显示 mirai-console started successfully.既启动成功 如下图所示
登录账号
登录命令
/login <qq> [password] [protocol]
验证账号
首次登录需要验证,如图所示,输入TxCaptchaHelper,同时去Github下载滑动验证助手,在手机上安装好,然后依靠提示完成验证。
设置自动登录
自动登录
/autoLogin add <account> <password> [passwordKind] # 添加自动登录, passwordKind 可选 PLAIN 或 MD5
更改登录设备
更改设备
/autoLogin setConfig <account> <configKey> <value> # 设置一个账号的一个配置项
这些设置好,每次启动都会自动以设定的设备登录
其他命令可输入问号 ? 即可得到提示
其他命令
/autoLogin add <account> <password> [passwordKind] # 添加自动登录, passwordKind 可选 PLAIN 或 MD5
/autoLogin clear # 清除所有配置
/autoLogin list # 查看自动登录账号列表
/autoLogin remove <account> # 删除一个账号
/autoLogin removeConfig <account> <configKey> # 删除一个账号的一个配置项
/autoLogin setConfig <account> <configKey> <value> # 设置一个账号的一个配置项
/help # 查看指令帮助
/login <qq> [password] [protocol] # 登录一个账号
/logout <qq> # 登出一个账号
/permission cancel <被许可人 ID> <权限 ID> # 撤销一个权限
/permission deny <被许可人 ID> <权限 ID> # 撤销一个权限
/permission remove <被许可人 ID> <权限 ID> # 撤销一个权限
/permission cancelAll <被许可人 ID> <权限 ID> # 撤销一个权限及其所有子权限
/permission denyAll <被许可人 ID> <权限 ID> # 撤销一个权限及其所有子权限
/permission removeAll <被许可人 ID> <权限 ID> # 撤销一个权限及其所有子权限
/permission listPermissions # 查看所有权限列表
/permission lp # 查看所有权限列表
/permission permit <被许可人 ID> <权限 ID> # 授权一个权限
/permission grant <被许可人 ID> <权限 ID> # 授权一个权限
/permission add <被许可人 ID> <权限 ID> # 授权一个权限
/permission permittedPermissions <被许可人 ID> [包括重复] # 查看被授权权限列表
/permission pp <被许可人 ID> [包括重复] # 查看被授权权限列表
/permission grantedPermissions <被许可人 ID> [包括重复] # 查看被授权权限列表
/permission gp <被许可人 ID> [包括重复] # 查看被授权权限列表
/status # 获取 Mirai Console 运行状态
/stop # 关闭 Mirai Console
/mclc <MCL命令行参数>
/mcl info <package> # 获取包信息
/mcl install <package> [channel] [type] [version] [lock or unlock] # 安装包
/mcl list # 列出已安装的包
/mcl remove <package> [delete] # 移除包
/mcl run <script> # 执行脚本load阶段
/mcl update # 执行updater脚本