1. 1.

   选择系统和运行方式
2. 2.

   部署文件
3. 3.

   运行
4. 4.

   登录

   1. 1.

      调整登录配置
   2. 2.

      登录
5. 5.

   客制化

先导表格，下面有具体说明

• windows(不一一列举)

  1. 1.

     以源码形式运行

     • 需要手动安装依赖 是源码运行 适合进阶玩家 支持更多依赖（毕竟自己手动配置）
  2. 2.

     以整合包方式运行

     • 一键安装 是exe运行 适合新手玩家 对于更多依赖暂时还不支持
• linux(不一一列举)

  1. 1.

     以源码形式运行

     • linux目前没有一键包 需要手动安装依赖 需要手动配置 是源码运行 适合进阶玩家 支持更多依赖（毕竟自己手动配置）

1. 1.

   将整个整合包解压到你想要的文件夹里去 建议路径全英文，中文也行
2. 2.

   观察是否满足整合包要求

   1. 1.

      在整合包的根目录下有一个OlivOS.exe
   2. 2.

      在整合包的lib目录下有一个go-cqhttp.exe
   3. 3.

      在整合包的plugin\app目录下有一个OlivaDiceCore的文件夹或者.opk文件
   4. 4.

      如果以上条件满足,请开始下一步 否则请换一个整合包 或者参考Win的以源码模式运行章节 进行资源文件补齐
3. 3.

   在满足上述要求后,观看后面的运行章节

1. 1.

   基础条件

   1. 1.

      能直接访问Github 或者会使用各种镜像站下载
   2. 2.

      有Chrome,FireFox,Edge等 任意一种常见的Chrome内核浏览器 这个不作强制要求,但是推荐使用 防止因为浏览器原因导致的无法打开Github
2. 2.

   开始安装

   1. 1.

      你需要安装python3.7.5以上版本 Python官网下载地址:https://www.python.org/downloads/ 安装过程请记得将添加环境变量(Add Python 3.xx to PATH)的√勾上
   2. 2.

      从Github下载OlivOS-Team/OlivOS（OlivOS框架）源码
   3. 3.

      解压到你喜欢的文件夹/路径下面 这里假设你放在了D:\OlivOS路径下 在此路径下能直接看见main.py
   4. 4.

      安装requirements依赖

      1. 1.

         打开cmd输入以下指令然后执行 cd D:\OlivOS && pip install -r requirements.txt
      2. 2.

         如果下载速度缓慢请自行切换镜像站下载，例： cd D:\OlivOS && pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

         • 想要通过不同的镜像站进行下载 请自行通过搜索引擎寻找更多镜像站（如Baidu,Google）
      3. 3.

         或者在scrpits\目录下找到install.bat来安装依赖 如果安装缓慢可以尝试第一步的第二种方法
   5. 5.

      从Github下载OlivOS-Team/OlivaDiceCore（OlivaDiceCore）源码

      • 下载完成后解压压缩包里的OlivaDiceCore到 D:\OlivOS\plugin\app\路径下
      • 完整路径应该是D:\OlivOS\plugin\app\OlivaDiceCore\ 而且打开后能直接看见main.py
      • 如果不是,可能是你的文件夹套娃了 请剪切出来 或者从releases直接下载以.opk结尾的插件
      • 下载完成后直接放在D:\OlivOS\plugin\app\路径下
   6. 6.

      从Github的go-cqhttp/releases下载go-cqhttp_windows_amd64.exe​

      • 如果有qq平台账号登录需求
      • 或者通过整合包复制一个过来
      • 下载完成后放在lib目录下
      • 重命名go-cqhttp_windows_amd64.exe为go-cqhttp.exe
   7. 7.

      观看后面的运行章节

1. 1.

   第一种方式： 直接使用自带启动脚本 进入D:\OlivOS\scripts\文件夹 直接运行start.bat即可
2. 2.

   第二种方式：手打指令 Win+R 在弹出的窗口输入cmd 点击确定 输入python D:\OlivOS\main.py

这里仅说QQ端的， 其他端请参考Oliva|3启程手册进行类比

1. 1.

   点击开启OlivOS后出现的窗口内的NEW按钮
2. 2.

   账号密码应该是常识
3. 3.

   PLATFORM：选择平台，应该是常识
4. 4.

   SDK：选你顺眼的
5. 5.

   MODEL：gocqhttp-show
6. 6.

   Auto：True 到这就好了
7. 7.

   点击Save
8. 8.

   如果需要go-cqhttp与OlivOS分离运行的可以看第六段 关于手动配置go-cqhttp的那些事 这里建议登录成功后再去看 还没学会走路就想着跑步只会摔个大跟头
9. 9.

   可以重复此操作直到所有账号全录入完毕

   1. 1.

      如果有多个qq的需求 建议在成功登录一个以后 学习使用分离运行的方法

1. 1.

   点击Commit
2. 2.

   在go-cqhttp的窗口内扫描二维码（一般是这样） 如果二维码显示不全可以去这个路径 conf\gocqhttp\{Hash}\qrcode.png 打开这个二维码使用qq扫描登录 或者直接拉一下（不要左右拉，二维码会消失）

1. 1.

   删除conf\basic.json里第七行的 "OlivOS_multiLoginUI", 所在的一整行
2. 2.

   如果想要继续添加这个框就把这一行加回去

1. 1.

   在OlivOS控制台可以看见如.master xxxxxxxx-xxxx-xxxxx-xxxxxx-xxxxxxxx类似的语句。
2. 2.

   在私聊窗口向骰娘发送这一句

1. 1.

   输入.help master

所以需要同时调整OlivOS和go-cqhttp的设置

1. 1.

   这里本质上是网络通讯 所以你甚至可以把OlivOS和go-cqhttp放在两个不同的电脑上 只要能互相ping通就行 或者就直接本机运行 因此引出下面的两个路径
2. 2.

   如果你需要OlivOS和go-cqhttp分离运行 把想要设置的相关账号里的MODEL改为Default 并把Auto改为False
3. 3.

   全自动配置的go-cqhttp相关文件会在conf/gocqhttp/{Hash}/路径下生成， 所以你可以把lib里的go-cqhttp.exe复制进去 或者搞懂原理以后随便你在哪里运行 甚至是另一个电脑 另一个服务器，包括手机上之类的

1. 1.

   OlivOS

   1. 1.

      运行OlivOS

      (linux用户可以考虑先windows上生成一个以后复制过去,或者熟记结构以后手搓)

   2. 2.

      按照正常流程设置一遍虚拟账号密码 比如账号为1,密码为1 设置auto,设置qq,onebot 点击save,此时应当看见一个已经保存成功的账号为1的条目 点击commit
   3. 3.

      关闭OlivOS,此时已经生成填写模板了
2. 2.

   go-cqhttp

   1. 1.

      运行go-cqhttp.exe

      1. 1.

         选择确定*3
      2. 2.

         这是为了释放go-cqhttp启动脚本 如果已经有了请跳过这两步
   2. 2.

      运行go-cqhttp.bat

      1. 1.

         输入0选择HTTP通讯
      2. 2.

         关闭cmd窗口
      3. 3.

         这是为了生成config.yml 如果已经有了请跳过这一步

1. 1.

   OlivOS(框架)

   1. 1.

      account.json（文件）

      1. 1.

         id：输入你的骰娘qq
      2. 2.

         password：随便填，或者不填也行 账号密码核心设置在go-cqhttp那
      3. 3.

         server

         1. 1.

            host:你的go-cqhttp服务所在ip 如果是本机可填http://127.0.0.1 你接收完消息,处理完毕以后 需要发到go-cqhttp上去 然后交由go-cqhttp发送到腾讯聊天服务器上去 所以这里是你的go-cqhttpip地址
         2. 2.

            port:端口号，与go-cqhttp上设置的一致
         3. 3.

            access_token:随意编造一个 建议设置的复杂一点 这个可以类比成和go-cqhttp通讯时的密码
   2. 2.

      basic.json（文件）

      1. 1.

         models

         1. 1.

            OlivOS_flash_post_rx

            1. 1.

               server

               1. 1.

                  port 设置端口号 推荐自动以后改手动
               2. 2.

                  host就默认0.0.0.0好了 当然如果不涉及多机通讯可以127.0.0.1
2. 2.

   go-cqhttp(运行文件)

   1. 1.

      config.yml（文件）

      1. 1.

         account

         1. 1.

            uin: 输入你的骰娘qq,和上面的一致
         2. 2.

            password就留空,扫码登录就好
      2. 2.

         default -middlewares

         1. 1.

            access-token：这个的填写和access_token一致 在OlivOS发送给gcq的时候gcq会根据这个来鉴权 所以请务必保证这个密钥的强度够高
      3. 3.

         servers

         1. 1.

            http

            1. 1.

               host：填写你go-cqhttp运行服务器所在ip 如果就是本机的话可以直接输入localhost 如果是远程请务必不要使用localhost或者127.0.0.1 请填写你自己的服务器ip地址 否则回复消息无法送达

               举例一： A服务器ip为192.168.1.10，运行OlivOS B服务器ip为192.168.1.11，运行go-cqhttp B服务器此处应当填写的是192.168.1.11 或者0.0.0.0 ……………分割线………………… 举例二： A服务器ip为192.168.1.3 同时运行OlivOS和go-cqhttp 那么只要填127.0.0.1就好了 ……………分割线………………… 简单来说就是 如果你的OlivOS和go-cqhttp不在同一个ip上 请参照举例一 如果在同一个电脑上 请参照举例二

            2. 2.

               port：

               1. 1.

                  这个port和上面account.json里的port保持一致 否则无法通信
            3. 3.

               secret目前似乎不需要填写 等待纠正中 (疑似是发给OlivOS的时候让OlivOS鉴权用的)