chatluna

一个插件接入多款大模型,让聊天机器人更聪明

开源 🏷️定价信息待确认 ✅ 目前可打开 对话助手 🍴 复刻 51 🐛 待处理 6 👀 关注 3
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 445
维护状态 较活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

chatluna 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类对话助手
开发团队ChatLunaLab
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议AGPL-3.0
主要语言TypeScript
技术栈/模型agent,ai,bot,chatbot,chatglm,chatgpt,claude,deepseek,gemini,gpt,koishi,langchain,llm,mcp-client,openai,plugin,qq-bot,qwen,typescript
GitHub 星标★ 445
上线时间2023-04-06 00:00:00
代码更新2026-10-28
仓库体积25.5 MB
本站数据更新2026-11-09
维护状态较活跃
收录时间2026-08-09
浏览次数5

项目介绍

ChatLuna 是一个基于 Koishi 框架的多平台大语言模型聊天插件,旨在为 QQ、Telegram 等聊天平台提供统一的 AI 对话能力。它解决的是不同模型和平台之间碎片化接入的问题,通过插件化架构支持 OpenAI、Claude、Gemini、DeepSeek、ChatGLM 等多种主流模型,并允许用户灵活切换或组合使用。核心能力包括多模型动态路由、可扩展的适配器机制、多种输出格式(文本、Markdown、卡片等),以及通过 MCP 客户端集成外部工具,从而增强聊天机器人的功能边界。项目采用 TypeScript 开发,适合开发者快速构建定制化的 AI 聊天机器人,尤其适用于需要多模型对比或私有化部署的场景。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 445

技术标签

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:进阶 约 40 分钟 部署方式:本地构建 4 步

环境要求

  • Node.js 20+
  • Koishi 实例
  • 一个模型 API

安装与启动步骤

  1. 1先装 Koishi

    它是 Koishi 的插件,宿主不在就没法跑。

  2. 2克隆依赖的子包

    仓库有脚本把同组织的子包拉齐。

    npm run clone ChatLunaLab/chatluna
  3. 3构建插件

    构建目标指定到 Koishi 适配包。

    npm run build -w @root/chatluna-koishi
  4. 4在 Koishi 里启用并配模型

    填上模型 key 与适配的平台,再拉进群测试。

如何确认成功

在群聊里 @ 它能得到回复,并且同一群的历史上下文能被带到下一轮

注意事项

  • 它是聊天机器人插件,价值在于把模型接进群聊而不是单机对话。
  • Koishi 生态版本耦合紧,装之前对齐版本。
  • 群聊上下文要有长度上限,否则费用会失控。
  • 多平台适配各自要配凭据,先跑通一个再扩。

核心亮点

  • 支持 OpenAI、Claude、Gemini 等主流模型,且可动态切换,避免厂商锁定
  • 基于 Koishi 插件生态,安装配置简单,适合快速集成到 QQ 等平台
  • 内置 MCP 客户端,可扩展工具调用,增强对话实用性

不足之处

  • 早期项目,文档和社区支持待观察
  • 依赖 Koishi 框架,非 Koishi 用户上手成本较高

适用场景

  • 在 QQ 群中部署多模型 AI 助手,供群成员提问
  • 对比不同大模型回复质量,用于评测或选择模型
  • 为个人或团队搭建私有化聊天机器人,接入内部工具

替代项目

LangChain、ChatGPT-Next-Web、nonebot-plugin-chatgpt

上一篇:ai-agent-tools

下一篇:chat2graph

同类项目推荐

orchestrator-supaconductor 开源

让 Claude Code 组队并行干活,还自带评审把关

Multi-agent orchestration system for Claude Code with parallel execution, automated ···

★ 381 2026-09-30
EvoCUA 开源

让AI学会操作电脑,自动搞定跨应用任务

EvoCUA: Evolving Computer Use Agent

★ 355 2026-08-09
aci 开源

给AI代理接上600+工具,一个平台搞定所有调用

ACI.dev is the open source tool-calling platform that hooks up 600+ tools into any a···

★ 4933 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3426 2026-09-12
metaswarm 开源

把多个 AI 编码助手编成一条带测试与质检的流水线

A self-improving multi-agent orchestration framework for Claude Code, Gemini CLI, an···

★ 426 2026-11-10
ai-companion-kit 开源

让 AI 有记忆会聊天,还能用 adb 操控你的安卓手机

给你的 AI 一副身体,和一点人味 —— 会记事、会看场合的 QQ 陪聊 + 能控制安卓手机的 MC···

★ 565 2026-10-21
pdf-reader-mcp 开源

让 AI 看懂 PDF:结构化提取、表格 OCR、带页码引用,本地运行。

Any file → clean Markdown for AI agents: PDF, Word, PowerPoint, Excel, EPUB, HTML a···

★ 1068 2026-08-09
zlibrary-mcp 开源

让 AI 直接搜索下载书籍并读取内容,喂给大模型做知识库

MCP server that finds books across catalogues and downloads the original files

★ 116 2026-08-09