快速上手
本节,我们将指导你如何安装与配置 ChatLuna,让你能快速的和模型进行对话。
安装插件
在使用 ChatLuna 之前,你需要安装 Koishi。
按照 Koishi 官方文档 来安装 Koishi。
提示
社区成员为 Windows 和 Linux 提供了一键安装脚本,该脚本可以一键自动安装 Koishi 以及 ChatLuna。 项目地址:https://github.com/hxsyzl/chatluna-install-auto
配置聊天平台
安装 Koishi 后,你需要选择一个聊天平台来接入机器人,或使用 沙盒环境 测试。
如你选择使用沙盒环境,可以直接跳到 下一步。
如你选择接入实际的聊天平台,请参考 接入真实聊天平台。
安装前置依赖服务
安装 ChatLuna 的必要前置依赖服务,ChatLuna 需要这些服务来提供基础功能。
数据库服务
ChatLuna 需要 database
服务,用于存储会话信息等持久化数据。
我们推荐使用 database-sqlite
,它自带在大部分 Koishi 环境里,已被默认安装并启用。
你也可以安装并配置其他在 Koishi 插件市场上的数据库插件,如 MySQL、MongoDB 等。
可选服务
这些服务是为了 ChatLuna 的某些功能而额外需要的服务。你可以根据需要选择安装。
censor
服务:用于回复内容过滤。注意,有的插件不审核文本信息,请注意识别。vits
服务:用于渲染模型回复,生成语音。
安装主插件
搜索并安装 chatluna
插件,这是 ChatLuna 的主插件。
注意
主插件本身不包含任何模型适配器,无法直接对话,还需安装模型适配器。
安装模型适配器
安装你需要平台的模型适配器。在插件市场输入 ChatLuna + <adapter>
搜索并选择你需要的适配器安装。
你可同时安装多个平台的模型适配器,后续可通过模版房间配置或房间里的模型配置项切换。
配置插件
进入主插件配置页面,以下是一些重要的配置项,其他配置项可在 配置项 了解到:
isProxy
:是否使用代理,对国内用户强烈推荐开启。proxyAddress
:代理地址,格式为http://host:port
。outputMode
:回复的输出格式,支持语音、文本、图片等。
配置模型适配器
参考 模型平台,选择你需要配置的模型平台类型。
注意
如果你所在的地区无法访问某些模型 API 服务,则可能需要设置代理。请在 ChatLuna
主插件的设置里设置代理(请求设置 -> isProxy
,请求设置 -> proxyAddress
)。
可使用 chatluna.model.list
查看可用的模型。
设置模版房间配置
在控制面板里可设置模版房间的相关配置,如图所示:
设置好模型,聊天模式和预设,右上角保存后即完成配置。
提示
对于初次使用 ChatLuna 的新手,我们推荐直接使用模型克隆房间。当你对 ChatLuna 有深入了解后,才推荐使用自定义的房间系统。
开始聊天
最后使用 chatluna.chat.text
命令,即可和模型进行交互对话。
通过以上步骤,你已经基本配置好了 ChatLuna,并且可以和模型对话了。
接下来你可以在下面的章节学习到更多的配置和使用方法。