ChatLunaLab/chatluna

这是什么？

核心功能

• 01接入 OpenAI、Gemini、Claude、DeepSeek、通义千问、Ollama 等多家模型。
• 02提供聊天、浏览、Agent 三种对话模式。
• 03通过 YAML 预设文件自定义人格。
• 04支持文字、语音、图片渲染及混合输出。
• 05支持流式响应，以及多模态模型的图片输入。
• 06内置速率限制、黑名单和 MCP 客户端。

适用场景

• 在通过 Koishi 运行的 QQ 群聊中加入大模型助手。
• 让机器人结合联网搜索结果回答问题。
• 通过预设文件为不同群组设置不同人格。
• 基于 LangChain 和 Koishi 快速开发新的模型适配器。

快速上手

1. 1

   在 Koishi 项目中安装本插件（参见部署文档）

2. 2

   使用 yarn 将 ChatLuna 克隆到 Koishi 模版项目中

   yarn clone ChatLunaLab/chatluna
3. 3

   首次使用前构建一次项目

   yarn workspace @root/chatluna-koishi build
4. 4

   以开发模式启动模版项目

   yarn dev

使用前须知

• !项目处于缓慢开发状态，正在准备 v2 版本。
• !Claude 等模型提供商需要自备 API Key，且部分收费。
• !项目采用 AGPL-3.0 许可证，这是一种适用于衍生作品的 Copyleft 许可证。

收录于专题

标签

常见问题

chatluna 是什么？

Koishi 机器人插件，为 QQ 等聊天机器人接入多家大模型，支持预设人格与多种输出格式。 ChatLuna 是 Koishi 聊天机器人框架的插件，让机器人借助大语言模型进行对话。它接入了 OpenAI、Azure OpenAI、Gemini、Claude、DeepSeek、通义千问、豆包、智谱、讯飞星火、文心一言、混元、Ollama、RWKV 等多家模型或平台，在 Koishi 中可直接安装，无需手动编辑配置文件。

chatluna 可以免费使用吗？用的什么许可证？

chatluna 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

chatluna 还在维护吗？

活跃维护中。chatluna 最近一次提交是在 2026年10月28日。

chatluna 适合用来做什么？

在通过 Koishi 运行的 QQ 群聊中加入大模型助手。 让机器人结合联网搜索结果回答问题。 通过预设文件为不同群组设置不同人格。 基于 LangChain 和 Koishi 快速开发新的模型适配器。

chatluna 怎么安装和运行？

在 Koishi 项目中安装本插件（参见部署文档） 使用 yarn 将 ChatLuna 克隆到 Koishi 模版项目中: yarn clone ChatLunaLab/chatluna 首次使用前构建一次项目: yarn workspace @root/chatluna-koishi build 以开发模式启动模版项目: yarn dev

在哪里获取 chatluna？

源代码和安装说明在 GitHub 上：https://github.com/ChatLunaLab/chatluna