Skip to content

快速上手

本节,我们将指导你如何安装与配置 ChatLuna,让你能快速的和模型进行对话。

安装 Koishi

在使用 ChatLuna 之前,你需要安装 Koishi。

按照 Koishi 官方文档 来安装 Koishi。

配置聊天平台

安装 Koishi 后,你需要选择一个聊天平台来接入机器人,或使用 沙盒环境 测试。

如你选择使用沙盒环境,可以直接跳到 下一步

如你选择接入实际的聊天平台,请参考 接入真实聊天平台

安装前置依赖服务

安装 ChatLuna 的必要前置依赖服务,ChatLuna 需要这些服务来提供基础功能。

数据库服务

ChatLuna 需要 database 服务,用于存储会话信息等持久化数据。

我们推荐使用 database-sqlite,它自带在大部分 Koishi 环境里,已被默认安装并启用。

你也可以安装并配置其他在 Koishi 插件市场上的数据库插件,如 MySQL、MongoDB 等。

可选服务

这些服务是为了 ChatLuna 的某些功能而额外需要的服务。你可以根据需要选择安装。

  • censor 服务:用于回复内容过滤。注意,有的插件不审核文本信息,请注意识别。
  • vits 服务:用于渲染模型回复,生成语音。

安装主插件

搜索并安装 chatluna 插件,这是 ChatLuna 的主插件。

注意

主插件本身不包含任何模型适配器,无法直接对话,还需安装模型适配器。

安装模型适配器

安装你需要平台的模型适配器。在插件市场输入 ChatLuna + <adapter> 搜索并选择你需要的适配器安装。

image

你可同时安装多个平台的模型适配器,后续可通过模版房间配置或房间里的模型配置项切换。

配置主插件

进入主插件配置页面,以下是一些重要的配置项,其他配置项可在 配置项 了解到:

  • isProxy:是否使用代理,对国内用户强烈推荐开启。
  • proxyAddress:代理地址,格式为 http://host:port
  • outputMode:回复的输出格式,支持语音、文本、图片等。

配置模型适配器

参考 模型平台,选择你需要配置的模型平台类型。

注意

如果你所在的地区无法访问某些模型 API 服务,则可能需要设置代理。请在 ChatLuna 主插件的设置里设置代理(请求设置 -> isProxy,请求设置 -> proxyAddress)。

可使用 chatluna.model.list 查看可用的模型。

设置模版房间配置

在控制面板里可设置模版房间的相关配置,如图所示:

images

设置好模型,聊天模式和预设,右上角保存后即完成配置。

提示

对于初次使用 ChatLuna 的新手,我们推荐直接使用模型克隆房间。当你对 ChatLuna 有深入了解后,才推荐使用自定义的房间系统。

开始聊天

最后使用 chatluna.chat.text 命令,即可和模型进行交互对话。

通过以上步骤,你已经基本配置好了 ChatLuna,并且可以和模型对话了。

接下来你可以在下面的章节学习到更多的配置和使用方法。

页面历史

在 CC-BY-SA-4.0 许可下发布