跳转至

账号管理

账号系统介绍

总的来说，OlivOS是一个可以同时支持多平台与多账号的交互栈框架，对于OlivOS来说，每一个账号都是一个独立的连接实例，你可以通过配置来对其进行分配。

账号配置文件

账号配置文件通常为conf/account.json，这是一个JSON格式的配置文件，你可以通过修改这个文件来对账号进行配置，但是在Win平台上，你还可以用启动时会自动启动的账号编辑器来进行管理，账号编辑器将会按照后文中账号类型与条目对应的关系来自动帮你填写必要的信息，并为你提供填写其余部分的输入框，并帮助你检查是否填写妥当。

如下图所示，这是一个账号编辑器的截图，你可以在这里对账号进行编辑。

User_Account_002

文件格式

{
    "account": [
        {
            "id": 114514,
            "password": "THISISNOTYOURPASSWORD",
            "sdk_type": "kaiheila_link",
            "platform_type": "kaiheila",
            "model_type": "default",
            "server": {
                "auto": true,
                "type": "websocket",
                "host": "THISISNOTYOURHOST",
                "port": 2333,
                "access_token": "THISISNOTYOURTOKEN"
            },
            "extends": {},
            "debug": false
        }
    ]
}
名称 类型 解释 缺省
id number
string		 机器人ID，通常用于机器人进行登录和自我辨识 -
platform_type string 消息源平台实际平台
例如onebot、telegram_poll、kaiheila_link		 -
sdk_type string 消息源所基于SDK
例如qq、telegram、kaiheila		 -
model_type string 消息源所基于模块模式
例如default		 -
password string 机器人密码，通常用于登录，有时也用于储存应用密钥 -
server object 服务器信息 -
server.auto bool 服务器配置模式 -
server.type string 服务对接类型 -
server.host string 服务器地址 -
server.port number 服务器接口 -
server.access_token string 服务器鉴权TOKEN -
extends object 扩展字段，某些账号类型会使用 -

这些条目并不是大多数时候都在所有平台都有用，许多平台只需要一些特定的条目，后文将会对这些对应情况进行说明。
你需要关注的是sdk_type、platform_type、model_type这些条目，它们将直接决定OlivOS对待该条账号配置的模式。

PS：通常来说，OlivOS会以id、platform_type、sdk_type、三者的组合唯一的确定一个账号实例，并生成一个唯一对应的哈希值，如果你关注日志，你或许会看到它，这在某些插件中是有用的。

账号类型条目对应

以下内容将会以account条目下数组中的成员为例进行说明。
其中固定配置代表了只有在这些配置项被配置的时候才会被指定为该种连接，而所需配置代表了在这种连接模式下要配置的最小规模，没有被列举的条目则表示可选，通常也不会发挥作用。
通常，这些组合方式已经被配置为了OlivOS各种账号类型，你可以在账号编辑器中选择它们。

QQ

以下是几种对接QQ平台的方法

QQ/NapCat/默认

NapCatQQ是一个基于Onebot协议的QQ机器人协议端，它以PC端的NTQQ为基础使用了先进的技术进行实现，是go-cqhttp的优秀替代品与接替者，这是它的官方页面NapCatQQ
这种连接方式会由OlivOS自动接管NapCatQQ的启动流程。
目前强烈推荐该种方法，此外它还支持以onebotV11/Http进行分离式部署。

固定配置

名称 配置
platform_type "qq"
sdk_type "onebot"
model_type "napcat_show"
server.auto true
server.type "post"

所需配置

名称 填写说明
id 填写机器人账号ID

QQ/GoCq

go-cqhttp是一个基于Onebot协议的QQ机器人协议端，这是它的官方页面go-cqhttp
这种连接方式会由OlivOS自动接管go-cqhttp的启动流程。
目前强烈推荐QQ/GoCq/安卓手机和QQ/GoCq/安卓平板，因为这两种模式收到了OlivOS的特别技术支持。

固定配置

名称 配置
platform_type "qq"
sdk_type "onebot"
model_type 详见可变配置
server.auto true
server.type "post"

可变配置

账号类型 model_type
QQ/GoCq/默认 "gocqhttp_show"
QQ/GoCq/安卓手机 "gocqhttp_show_Android_Phone"
QQ/GoCq/安卓平板 "gocqhttp_show_Android_Pad"
QQ/GoCq/安卓手表 "gocqhttp_show_Android_Watch"
QQ/GoCq/iPad "gocqhttp_show_iPad"
QQ/GoCq/iMac "gocqhttp_show_iMac"
QQ/GoCq/旧 "gocqhttp_show_old"

所需配置

名称 填写说明
id 填写机器人账号ID
password 填写机器人账号密码

QQ/WQ

这种连接方式会由OlivOS自动接管walle-q的启动流程。

固定配置

名称 配置
platform_type "qq"
sdk_type "onebot"
model_type 详见可变配置
server.auto true
server.type "websocket"

可变配置

账号类型 model_type
QQ/Wq/默认 "walleq_show"
QQ/Wq/安卓手机 "walleq_show_Android_Phone"
QQ/Wq/安卓平板 "walleq_show_Android_Pad"
QQ/Wq/安卓手表 "walleq_show_Android_Watch"
QQ/Wq/iPad "walleq_show_iPad"
QQ/Wq/iMac "walleq_show_iMac"
QQ/Wq/旧 "walleq_show_old"

所需配置

名称 填写说明
id 填写机器人账号ID
password 填写机器人账号密码

QQ/OPQ

这种连接方式会由OlivOS自动接管OPQBot的启动流程。
请注意，OPQBot（原IOTQQ）基于远程协议端实现，可以基本理解为，在远程服务器上为你的账号分配一个QQ虚拟机，而OlivOS对接的OPQBot只是一个连接这个虚拟机的客户端，本地几乎没有什么东西，它需要将你的登录凭证上交至远端的OPQBot官方（与OlivOS无关的第三方），且OPQBot为闭源框架，该过程无法监督，所以你的账号几乎一定会面临安全风险（比如框架跑路后可能报废）；对于这类第三方的协议框架对接方式，如果出现这种情况，OlivOS官方将不会对此负责，也无法做出任何补偿，请仔细斟酌后再考虑使用该种登录方案，如果无法接受，OlivOS将同样为你提供其它更安全的登陆方式，OPQBot只是OlivOS已经对接的20多种对接方式中的一种。

对接此方法需要一个Token，你需要通过官方渠道获取Token申请和每日签到续签这个Token，这是OPQ官方要求的避免滥用的必要措施。
详情请参考说明

固定配置

名称 配置
platform_type "qq"
sdk_type "onebot"
model_type 详见可变配置
server.auto true
server.type "websocket"

可变配置

账号类型 model_type
QQ/OPQ/默认 "opqbot_auto"
QQ/OPQ/指定端口 "opqbot_port"
QQ/OPQ/指定端口/旧 "opqbot_port_old"

所需配置

名称 填写说明
id 填写机器人账号ID
server.port 需要填写协议端的WS端口
QQ/OPQ/默认中可随意填
server.access_token 填写从OPQBot官方获取的Token

分离式部署协议

使用这种方法部署意味着OlivOS将会作为一个不包含任何协议端功能的应用端使用，使用这种方法意味着你或许已经以各种方式获取到一个可以使用的协议端实例，而这里列出了OlivOS目前已经支持的各种协议

onebotV11/Http

这种连接方式适配了OnebotV11协议的Http接口，这种接口通常用于连接go-cqhttp、NapCatQQ、OpenShamrock、LiteLoader-OnebotV11等协议端。
OlivOS同样提供了对于这其中部分协议端的更进一步封装，这部分会在后文中提及，此处的连接方式是最为通用的连接方式。
需要注意的是，这种对接模式会生成以下两个通信：

  • 一个OlivOS向协议端方向的正向HTTP（协议端作为服务器），这个方向的监听端口由协议端开启，需要在账号信息中配置
  • 一个协议端向OlivOS方向的反向HTTP（OlivOS作为服务器），这个方向的的监听端口由OlivOS开启

如果需要指定配置则需要使用conf/basic.json配置文件进行配置，默认为55001，如果被占用则会自行寻找一个闲置端口，请关注日志
你需要在协议端配置http://<ip>:<port>/OlivOSMsgApi/<platform>/<sdk>/<model>的上报地址
如，http://127.0.0.1:55001/OlivOSMsgApi/qq/onebot/default

固定配置

名称 配置
platform_type "qq"
sdk_type "onebot"
model_type "default"
server.auto false
server.type "post"

所需配置

名称 填写说明
id 填写机器人账号ID
server.host 需要填写协议端的地址
server.port 需要填写协议端的端口
server.access_token 视情况填写，但最好不要空置

onebotV11/Http/Shamrock

此连接方式是onebotV11/Http的变体，它适配了OpenShamrock协议端，由于OpenShamrock未能完全实现onebotV11，且由于其基于的安卓Java原生中的orjson存在扩展后的JSON格式，所以有了本账号类型，以适配各种OpenShamrock独有的情形。

此方法对接Shamrock需要使用其自带的OnebotV11的功能，其中的：

  • 回调HTTP地址对应反向HTTP地址
  • 主动HTTP端口对应正向HTTP端口

001

固定配置

名称 配置
platform_type "qq"
sdk_type "onebot"
model_type "shamrock_default"
server.auto false
server.type "post"

所需配置

名称 填写说明
id 填写机器人账号ID
server.host 需要填写协议端的地址
server.port 需要填写协议端的端口
server.access_token 视情况填写，但最好不要空置

onebotV12/正向WS

这种连接方式适配了通用的OnebotV12协议的正向Websocket，这种接口通常用于连接Walle-q、ComWeChatBot等协议端。
OlivOS同样提供了对于这其中部分协议端的更进一步封装，这部分会在后文中提及，此处的连接方式是最为通用的连接方式。

固定配置

名称 配置
platform_type "qq"
"wechat"
sdk_type "onebot"
model_type "onebotV12"
server.auto false
server.type "websocket"

所需配置

名称 填写说明
id 填写机器人账号ID
server.host 需要填写协议端的地址
server.port 需要填写协议端的端口
server.access_token 视情况填写，但最好不要空置

RED协议

这种连接方式适配了Chronocat的RED协议，协议其实只是QQNT中hook数据的简单封装，OlivOS对此进行了适配。

固定配置

名称 配置
platform_type "qq"
sdk_type "onebot"
model_type "red"
server.auto false
server.type "websocket"

所需配置

名称 填写说明
id 填写机器人账号ID
server.host 需要填写协议端的WS地址
server.port 需要填写协议端的WS端口
server.access_token 视情况填写，但最好不要空置
extends.http-path 需要填写后续计划支持的协议端的HTTP地址
But……Chronocat停止维护了
所以这东西现在没用

OPQBot/正向WS

这种连接方式适配了OPQBot的正向Websocket协议。
请注意，OPQBot（原IOTQQ）基于远程协议端实现，可以基本理解为，在远程服务器上为你的账号分配一个QQ虚拟机，而OlivOS对接的OPQBot只是一个连接这个虚拟机的客户端，本地几乎没有什么东西，它需要将你的登录凭证上交至远端的OPQBot官方（与OlivOS无关的第三方），且OPQBot为闭源框架，该过程无法监督，所以你的账号几乎一定会面临安全风险（比如框架跑路后可能报废）；对于这类第三方的协议框架对接方式，如果出现这种情况，OlivOS官方将不会对此负责，也无法做出任何补偿，请仔细斟酌后再考虑使用该种登录方案，如果无法接受，OlivOS将同样为你提供其它更安全的登陆方式，OPQBot只是OlivOS已经对接的20多种对接方式中的一种。

对接此方法需要一个Token，你需要加入官方群进行Token申请和每日签到续签这个Token，这是OPQ官方要求的避免滥用的必要措施。

固定配置

名称 配置
platform_type "qq"
sdk_type "onebot"
model_type "opqbot_default"
server.auto false
server.type "websocket"

所需配置

名称 填写说明
id 填写机器人账号ID
server.host 需要填写协议端的WS地址
server.port 需要填写协议端的WS端口

其它平台

虽然QQ平台一直以来都是我们的工作重心，但OlivOS也同样活跃在其它的平台中，以下是一些其它平台的连接方式

微信/ComWeChat

这种连接方式会由OlivOS自动接管ComWeChatBot的启动流程。

固定配置

名称 配置
platform_type "wechat"
sdk_type "onebot"
model_type "ComWeChatBotClient"
server.auto true
server.type "websocket"

所需配置

名称 填写说明
id 填写机器人账号ID
password 填写机器人账号密码

KOOK

这种连接方式对接了KOOK开放平台的官方机器人接口。
KOOK官方的相关文档可以在这里找到。
其中消息兼容模式将会以纯文本的方式发送消息，这可以解决某些用户遇到的权限不足的问题。

固定配置

名称 配置
platform_type "kaiheila"
sdk_type "kaiheila_link"
model_type 详见可变配置
server.auto true
server.type "websocket"

可变配置

账号类型 model_type
KOOK "default"
KOOK/消息兼容 "text"

所需配置

名称 填写说明
server.access_token 填写从KOOK官方获取的Token

米游社/大别野

这种连接方式对接了米游社大别野开放平台的官方机器人接口。
米游社大别野相关的文档可以在这里找到。

固定配置

名称 配置
platform_type "mhyVila"
sdk_type "mhyVila_link"
model_type 详见可变配置
server.auto true
server.type "websocket"

可变配置

账号类型 model_type
米游社/大别野/公域 "public"
米游社/大别野/私域 "private"
米游社/大别野/沙盒 "sandbox"

所需配置

名称 填写说明
id 填写从米游社官方获取的Bot_Id
password 填写从米游社官方获取的Secret
server.access_token 填写从米游社官方获取的Pub_Key
server.port 机器人所应用的别野号
只有沙盒模式下需要填写特定别野号
上架后可以填写为0

B站直播间

这种连接方式对接了B站直播间的弹幕系统。
B站直播间/游客将会以游客方式对接，这种方式下将会只能浏览弹幕，不能发送消息。
B站直播间/登录将会进行二维码登录，这种方式可以正常发送消息，但由于弹幕20字数的限制，将会把消息分割发送。

固定配置

名称 配置
platform_type "biliLive"
sdk_type "biliLive_link"
model_type 详见可变配置
server.auto true
server.type "websocket"

可变配置

账号类型 model_type
B站直播间/游客 "default"
B站直播间/登录 "login"

所需配置

名称 填写说明
server.access_token 填写所要对接的直播间ID

QQ官方/V1

这种连接方式对接了QQ官方的开放平台机器人接口。
QQ官方开放平台的文档可以在这里找到。
所采用的机器人接口为V1版本，这种接口已经被官方升级为V2，但由于其向下兼容性较好，仍然可以使用，所以仍然保留。

固定配置

名称 配置
platform_type "qqGuild"
sdk_type "qqGuild_link"
model_type 详见可变配置
server.auto true
server.type "websocket"

可变配置

账号类型 model_type
QQ官方/公域/V1 "public"
QQ官方/私域/V1 "private"

所需配置

名称 填写说明
id 填写从QQ官方获取的AppID
server.access_token 填写从QQ官方获取的机器人令牌

QQ官方/V2

这种连接方式对接了QQ官方的开放平台机器人接口。
QQ官方开放平台的文档可以在这里找到。
所采用的机器人接口为V2版本，一些新的功能例如QQ群官方机器人需要这个版本的接口对接。
基于文档，不同的账号类型对应不同的intents，你可以在这里查看相关说明。
其对应关系如下：

账号类型 intents
QQ官方/公域/V2 GUILDS
DIRECT_MESSAGE
PUBLIC_GUILD_MESSAGES
PUBLIC_QQ_MESSAGES
QQ官方/公域/V2/纯频道 GUILDS
DIRECT_MESSAGE
PUBLIC_GUILD_MESSAGES
QQ官方/公域/V2/指定intents 指定
QQ官方/私域/V2 GUILDS
DIRECT_MESSAGE
GUILD_MESSAGES
QQ官方/私域/V2/指定intents 指定

其中，QQ官方/公域/V2/指定intents和QQ官方/私域/V2/指定intents可以直接指定intents，这可以帮助你更好的规划Bot的部署。

固定配置

名称 配置
platform_type "qqGuild"
sdk_type "qqGuildv2_link"
model_type 详见可变配置
server.auto true
server.type "websocket"

可变配置

账号类型 model_type
QQ官方/公域/V2 "public"
QQ官方/公域/V2/纯频道 "public_guild_only"
QQ官方/公域/V2/指定intents "public_intents"
QQ官方/私域/V2 "private"
QQ官方/私域/V2/指定intents "private_intents"

所需配置

名称 填写说明
id 填写从QQ官方获取的AppID
server.access_token 填写从QQ官方获取的AppSecret

Telegram

这种连接方式对接了Telegram官方的开放平台机器人接口。
Telegram官方的相关文档可以在这里找到。
根据相关文档，Telegram的机器人需要通过一个官方机器人@botfather来创建。

固定配置

名称 配置
platform_type "telegram"
sdk_type "telegram_poll"
model_type "default"
server.auto true
server.type "post"

所需配置

你会从官方获取到一个格式类似如下的字符串，它与id、server.access_token字段的对应关系如下。 

11451419198100:xxxxxxxxxxxxxxxxxxxxxxxxxx
|<----id---->|                           
|<---------server.access_token--------->|
名称 填写说明
id 填写从Telegram官方获取的ID
server.access_token 填写从Telegram官方获取的TOKEN

Discord

这种连接方式对接了Discord官方的开放平台机器人接口。
Discord官方的相关文档可以在这里找到。

固定配置

名称 配置
platform_type "discord"
sdk_type "discord_link"
model_type "default"
server.auto true
server.type "websocket"

所需配置

名称 填写说明
server.access_token 填写从Discord官方获取的TOKEN

渡渡语音/Dodo

这种连接方式对接了Dodo官方的开放平台机器人接口。
Dodo官方的相关文档可以在这里找到。
提供了V1、V2两个版本接口的对接，两个版本的接口在功能上没有区别，但是在ID对应关系上有一些区别，虽然Dodo官方提供了映射对应的接口，但是这个接口与V1版本接口的生命周期一致，并不能永久的保证配合V2接口的使用，因而这实际上是官方自上而下的破坏性更新，OlivOS在此特别区分两个版本。

固定配置

名称 配置
platform_type "dodo"
sdk_type "dodo_link"
model_type 详见可变配置
server.auto true
server.type "websocket"

可变配置

账号类型 model_type
渡渡语音/Dodo/V1 "v1"
渡渡语音/Dodo/V2 "default"

所需配置

名称 填写说明
id 填写从Dodo官方获取的BotID
server.access_token 填写从Dodo官方获取的Bot私钥

Fanbook

这种连接方式对接了Fanbook官方的开放平台机器人接口。
Fanbook官方的相关文档可以在这里找到。

固定配置

名称 配置
platform_type "fanbook"
sdk_type "fanbook_poll"
model_type "default"
server.auto true
server.type "post"

所需配置

名称 填写说明
server.access_token 填写从Fanbook官方获取的Token

钉钉

这种连接方式支持了钉钉官方开放平台的机器人接口。

固定配置

名称 配置
platform_type "dingtalk"
sdk_type "dingtalk_link"
model_type "default"
server.auto true
server.type "websocket"

所需配置

名称 填写说明
id 钉钉官方开放平台的机器人账号的Robot Code

Hack.Chat

这种连接方式对接了Hack.Chat聊天协议。

固定配置

名称 配置
platform_type "hackChat"
sdk_type "hackChat_link"
model_type 详见可变配置
server.auto true
server.type "websocket"

可变配置

账号类型 model_type
Hack.Chat "default"
Hack.Chat/私有 "private"

所需配置

名称 填写说明
id 所要连接的房间名称
server.access_token 连入房间的Bot名称
password 连入房间的Bot的pass鉴权
这是Hack.Chat协议的扩展内容
这可以有效避免被人顶替
extends.ws_path 私有的Websocket服务器地址
这个字段只在Hack.Chat/私有需要被配置

虚拟终端

这种连接方式支持你打开一个本地的虚拟聊天终端，你可以任意与Bot对话的身份与场景，主要可以用于插件的调试。

固定配置

名称 配置
platform_type "terminal"
sdk_type "terminal_link"
model_type "default"
server.auto true
server.type "websocket"

所需配置

名称 填写说明
id 虚拟的Bot账号ID

接口终端

这种连接方式支持你打开一个本地的虚拟聊天终端，不同之处在于这个终端的交互途径是HTTP接口，这可以用于一些网络应用的实现。
该方案充分考虑了并发压力，可以作为一个简单的HTTP接口服务器。

你将可以通过POST发送以下json表单来触发消息

{
    "type": "message",
    "message_type": "group_message",
    "group_id": "77777777",
    "user_id": "66666666",
    "message": ".rd",
    "sender": {
        "user_id": "66666666",
        "nickname": "质子"
    }
}

固定配置

名称 配置
platform_type "terminal"
sdk_type "terminal_link"
model_type "postapi"
server.auto true
server.type "post"

所需配置

名称 填写说明
id 虚拟的Bot账号ID
server.port 服务开放的端口

FF14终端

这种连接方式支持你打开一个本地的虚拟聊天终端，但它同时有一套完整的基于以下回路对接最终幻想14（FINAL FANTASY XIV）的技术支持。 

FF14 -> ACT -> Triggernometry -> OlivOS -> 鲇鱼精邮差 -> ACT -> FF14

相关的介绍在这里

固定配置

名称 配置
platform_type "terminal"
sdk_type "terminal_link"
model_type "ff14"
server.auto true
server.type "post"

所需配置

名称 填写说明
id 虚拟的Bot账号ID
server.port Triggernometry中使用的端口
server.access_token 鲇鱼精邮差的监听端口