+2
Daily
+30
Weekly
+191
Monthly
19,295
stars
1,835
forks
99
watchers
322
prs
1,111
issues
75
releases
README
Kirara AI
一款支持主流大语言模型、主流聊天平台的聊天的机器人!
» 查看项目手册 »
!cover
🌟 社区交流
加入我们的社区,获取最新项目动态、视频教程、问题答疑和技术交流!
QQ 交流群:
二群(已满)
三群(已满)
四群(已满)
五群
六群
提问前请先查看: 加入群组前,请先查看项目问题列表,看是否能解决你的问题。
如需提问,请准备好问题描述、完整日志和相关配置文件,以便我们更好地帮助你。
进群请备注:GitHub
机器人调试群 - 这里有多个 QQ 机器人供体验,不解答技术问题。
开发者交流群 - 欢迎参与 Kirara AI 及生态开发 / 对大模型应用有兴趣的开发者加入,一起交流学习。
📷 功能展示
| !猫娘问答 | !智能助手 | !沉浸式RPG |
|:-------------------------------:|:-------------------------------:|:-------------------------------:|
| !猫娘模式 | !日常助手 | !文字冒险 |
🧭 WebUI
模型管理
!image
工作流
!image
插件市场
!image
⚡ 核心特性
[x] 图片发送
[x] 关键词触发回复
[x] 多账号支持
[x] 人格设定
[x] 支持 QQ、Telegram、Discord、微信
[x] 可作为 HTTP 服务端提供 Web API
[x] 支持 OpenAI、DeepSeek、Claude、Gemini、Qwen、Mistral、豆包、Minimax、Kimi、Mistral 等主流大模型
[x] 支持插件机制
[x] 支持条件触发
[x] 支持管理员指令
[x] 支持 Stable Diffusion、Flux、Midjourney 等绘图模型
[x] 支持语音回复
[x] 支持多轮对话
[x] 支持跨平台消息发送
[x] 支持自定义工作流
[x] 支持 Web 管理后台
[x] 内置 Frpc 内网穿透
🤖 聊天平台
我们支持多种聊天平台。
| 平台 | 群聊回复 | 私聊回复 | 条件触发 | 管理员指令 | 绘图 | 语音回复 |
|----------|------|------|------|-------|-----|------|
| Telegram | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
| QQ 机器人 | 支持 | 支持 | 支持 | 支持 | 支持 | 平台不支持 |
| Discord | 重构中 | 重构中 | 重构中 | 重构中 | 重构中 | 重构中 |
| 飞书机器人 | 重构中 | 重构中 | 重构中 | 重构中 | 重构中 | 重构中 |
| 企业微信应用 | 支持 | 支持 | 支持 | 不支持 | 支持 | 支持 |
| 微信公众号 | 支持 | 支持 | 支持 | 不支持 | 支持 | 支持 |
| OneBot | 插件支持 | 插件支持 | 插件支持 | 插件支持 | 插件支持 | 插件支持 |
🐎 命令
你可以在 WebUI 的调度规则中自定义所有命令。
🔧 搭建
请移步至 快速开始
🕸 HTTP API
HTTP API 可用于接入其他平台。
在聊天平台管理中启动 http-legacy 适配器后,将提供以下接口:
POST /v1/chat
请求参数
|参数名|必选|类型|说明|
|:---|:---|:---|:---|
|session_id| 是 | String |会话ID,默认:friend-default_session|
|username| 是 | String |用户名,默认:某人|
|message| 是 | String |消息,不能为空|
请求示例
json
{
"session_id": "friend-123456",
"username": "testuser",
"message": "ping"
}
响应格式
|参数名|类型|说明|
|:---|:---|:---|
|result| String |SUCESS,DONE,FAILED|
|message| String[] |文本返回,支持多段返回|
|voice| String[] |音频返回,支持多个音频的base64编码;参考:data:audio/mpeg;base64,...|
|image| String[] |图片返回,支持多个图片的base64编码;参考:data:image/png;base64,...|
响应示例
json
{
"result": "DONE",
"message": ["pong!"],
"voice": [],
"image": []
}
POST /v2/chat
请求参数
|参数名|必选|类型|说明|
|:---|:---|:---|:---|
|session_id| 是 | String |会话ID,默认:friend-default_session|
|username| 是 | String |用户名,默认:某人|
|message| 是 | String |消息,不能为空|
请求示例
json
{
"session_id": "friend-123456",
"username": "testuser",
"message": "ping"
}
响应格式
字符串:request_id
响应示例
1681525479905
GET /v2/chat/response
请求参数
|参数名|必选|类型|说明|
|:---|:---|:---|:---|
|request_id| 是 | String |请求id,/v2/chat返回的值|
请求示例
/v2/chat/response?request_id=1681525479905
响应格式
|参数名|类型|说明|
|:---|:---|:---|
|result| String |SUCESS,DONE,FAILED|
|message| String[] |文本返回,支持多段返回|
|voice| String[] |音频返回,支持多个音频的base64编码;参考:data:audio/mpeg;base64,...|
|image| String[] |图片返回,支持多个图片的bTop issues
#1524对master 分支的类型检查发现了 22 个问题 (36249e4)0 comments · 2026-10-22#85搭建常见问题解答 | FAQ0 comments · 2023-02-09
Discussions
#1519现在QQ已经不用token鉴权了0 comments · 2026-06-11#1516Open source Claude Code investment skills — options flow scanner + price alerts0 comments · 2026-05-13#1491启动GPT时 browserless url报错5020 comments · 2025-06-27#1459预设系统现在不可用了吗?1 comments · 2025-04-14#1435配置qq机器人遇到问题1 comments · 2025-03-22#1399[早期预览版] WebUI 能力、插件系统、工作流设计0 comments · 2025-02-16#1396[早期预览版] WebUI 能力、插件系统、工作流设计2 comments · 2025-02-09#1368如何关闭流式传输0 comments · 2024-08-29
Latest release
v3.2.1 - 安全更新:修复 Web 面板认证绕过漏洞 v3.2.1 2026-10-22🔒 安全更新(强烈建议所有用户立即升级) 本版本修复了一个 Web 管理面板的严重安全漏洞。 如果你将实例暴露在公网上,请务必立即升级,不要延迟。 升级须知: - 升级后所有已登录会话将失效,需要重新登录(这是预期行为) - 升级不会影响 data 目录下的任何数据 - 如果你的实例曾暴露在公网,建议同时检查并轮换所有配置中的 API 密钥 如何部署? 请移步至这里。 如何升级? 可以从 WebUI 进行升级。 TIP: 如果遇到 WebUI 反复提示升级的情况,通常是因为浏览器缓存了旧版导致的,请按 Ctrl + Shift + R 或者 Shift + F5 强制刷新缓存。 也可以按照下面的方式进行手动升级: Docker 用户: bash docker compose pull && docker compose up -d Windows 用户: 下载下方快速启动包并解压,将旧版的 data 文件夹覆盖至新版即可。