快速上手
本节，我们将指导你如何安装与配置 ChatLuna，让你能快速的和模型进行对话。
安装 Koishi
在使用 ChatLuna 之前，你需要安装 Koishi。
Koishi 是一个跨平台、可扩展、高性能的聊天机器人框架。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> 搜索并选择你需要的适配器安装。
你可同时安装多个平台的模型适配器，后续可通过模版房间配置或房间里的模型配置项切换。
配置主插件
进入主插件配置页面，以下是一些重要的配置项，其他配置项可在 配置项 了解到：
defaultChatMode：默认的聊天模式。支持聊天模式，Agent 模式，浏览模式。outputMode：回复的输出格式，支持语音、文本、Koishi 元素等。
配置模型适配器
参考 模型平台，选择你需要配置的模型平台类型。
注意
如果你所在的地区无法访问某些模型 API 服务，则需要设置代理。请在 ChatLuna 主插件的设置里设置代理(请求设置 -> isProxy，请求设置 -> proxyAddress)。
你可以使用 chatluna.model.list 查看目前可用的模型。
配置模版房间
在控制面板里可设置模版房间的相关配置，如图所示：
设置好模型，聊天模式和预设，右上角保存后即完成配置。
提示
对于初次使用 ChatLuna 的新手，我们推荐直接使用模型克隆房间（即默认配置，无需操作）。当你对 ChatLuna 有深入了解后，才推荐使用自定义的房间系统。
下一步？
最后使用 chatluna.chat.text 命令，即可和模型进行交互对话。
通过以上步骤，你已经基本配置好了 ChatLuna，并且可以和模型对话了。
接下来你可以在下面的章节学习到更多的配置和使用方法。
