环境

本文介绍如何从零开始使Avalon可用。

适用于：Avalon v1.1.0+

环境准备

本节将配置Avalon运行的基本环境。

1. 下载并安装Java。

2. 下载并解压最新RELEASE 。

3. 重命名{解压目录}\bin\config_example.json为config.json。

4. 重命名{解压目录}\bin\group_example.json为group.json 。

5. 下载并安装酷Q Air / Pro。对以Mojo-Webqq作为后端的支持已于v1.1.0版本被移除。

   Avalon系面向酷Q Air开发、测试。并不要求酷Q Pro的扩展功能。

6. 遵照CoolQ HTTP API 插件文档 - 使用方法上的步骤配置CoolQ HTTP API。

7. **（可选）**若您需要使用Avalon的智能回复（AnswerMe）功能，请遵照Mojo-Weixin # 安装方法配置Mojo-Weixin。

基本配置

本节将配置Avalon运行的必要设置。完成本节后，Avalon已可正常运行。但强烈建议您完成在Avalon.wiki / 配置中给出的配置步骤后再启动Avalon。

配置config.cfg

5. 首次运行已正确载入CoolQ HTTP API的酷Q后，请在{CoolQ安装目录}\io.github.richardchien.coolqhttpapi\config.cfg文件中修改下列配置项：

   [general]
   host=0.0.0.0
   port=5000
   post_url=http://127.0.0.1:5050/post_url
   post_message_format=string
   update_channel=stable
   auto_check_update=yes
   auto_perform_update=yes

   适用于CoolQ HTTP API v3.3.x

   其中post_url配置项的主机部分要求与config.json中配置项servlet.listen_address相同；

   其中port配置项要求与config.json中配置项servlet.api_address的端口部分相同；

   其中host可改为127.0.0.1。

   未给出的配置项保持默认即可。

（可选）配置config.json

若您需要使用使用Avalon的智能回复（AnswerMe）功能，请配置config.json中AnswerMe.mojo-weixin_api_address配置项与Mojo-Weixin启动文件中$host和$port相同。

配置group.json

6. 请按以下说明修改您的group.json文件：

   文件包含一名称为groups的列表。请在列表中配置您想监听的各个QQ群。

   {
         "uid": 100000000,
         "listen": false,
         "record": false,
         "owner": 100000000,
         "admin": [
           100000000,
           100000000,
           100000000,
           100000000
         ]
   }

   以上摘取了groups列表中的其中一个配置块。若您想让Avalon监听多个QQ群，请在groups列表中复制多个以上配置块并用,分割。若您仅有一个需要监听的QQ群，请删除多余的配置块。以下将对配置块中的各个配置项进行说明。

   • uid：配置的QQ群号。
   • listen：是否监听本群。true监听，false不监听。
   • record：是否记录本群消息。true记录，false不记录。
   • owner：“所有者”权限持有的QQ号，有且仅有一人，需为uid指定的QQ群中的成员。指定的群员将拥有“所有者”权限，允许执行Avalon - 完整指令列表中的“所有者权限指令”。
   • admin：：“管理员”权限持有的QQ号（们），需为uid指定的QQ群中的成员。指定的群员（们）将拥有“管理员”权限，允许执行Avalon - 完整指令列表中的“管理员权限指令”。

在配置完group.json之后，Avalon已可运行了。

但我们仍然强烈建议您完成在Avalon.wiki / 配置中给出的配置步骤后再启动Avalon。