chatgpt-plugin

给云崽机器人装上 ChatGPT 大脑，QQ 秒变智能助手

chatgpt-plugin 是云崽（Yunzai-Bot）系机器人的智能聊天插件，专为 QQ 机器人生态设计。它解决了云崽机器人缺乏原生智能对话能力的问题，通过接入 ChatGPT 等大语言模型，让 QQ 机器人能够进行自然、多轮、上下文相关的对话。核心能力包括：支持多种 AI 模型（如 OpenAI、Azure、Claude 等）的灵活配置，提供上下文记忆、角色设定、指令触发、多会话管理等功能，并支持图片生成、语音回复等扩展。插件采用 JavaScript 编写，易于安装和二次开发，与云崽框架无缝集成，社区活跃，持续更新。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1076

维护状态活跃

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队ikechan8370

所属国家

官网地址https://www.yunzai.chat

GitHubhttps://github.com/ikechan8370/chatgpt-plugin

定价模式free

价格说明开源插件，GPL-3.0许可，免费使用，需自行部署到云崽机器人。

访问状态

是否开源是

开源协议GPL-3.0

主要语言JavaScript

技术栈/模型bot,chatgpt,qq,yunzai,yunzai-bot

GitHub 星标★ 1076

30天Star增速

HF 下载量

上线时间2022-12-06 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：本地安装 5 步

环境要求

已部署的 Miao-Yunzai / Yunzai-Bot 机器人框架
Node.js ≥ 18
pnpm ≥ 8
宿主环境可用的 sqlite3 驱动（本地记忆功能使用）
可选：sqlite-vec（仅用于向量检索增强，不可用时自动回退）

安装与启动步骤

1克隆插件代码

进入 Yunzai 根目录下的 plugins 目录，克隆插件仓库，确保插件放在 plugins/chatgpt-plugin 下。
```
cd plugins
git clone https://github.com/ikechan8370/chatgpt-plugin.git
```
2安装插件依赖

进入插件目录用 pnpm 安装依赖；sqlite-vec 为可选依赖，平台不支持时记忆功能仍可基础使用。
```
cd chatgpt-plugin
pnpm install
```
3启用插件

重启机器人或运行 node app 让插件自动加载，首次启动会生成配置目录与文件。
```
node app
```
4修改配置文件

在 plugins/chatgpt-plugin/config/ 下编辑 config.json 或 config.yaml，设置触发方式、默认模型等，保存后自动热加载。
5保持更新

主人账号在 QQ 发送更新指令同步仓库并更新 chaite 依赖；强制更新会丢弃本地修改，谨慎使用。
```
#chatgpt更新
```

关键配置

配置项	必填	说明	示例
`basic.toggleMode`	否	触发方式，可选 at（@Bot）或 prefix（前缀）	`at`
`basic.togglePrefix`	否	prefix 模式下触发聊天用的前缀词	`#chat`
`basic.commandPrefix`	否	管理指令前缀	`#chatgpt`
`llm.defaultModel`	否	默认使用的对话模型	`gpt-4o-mini`
`llm.defaultChatPresetId`	否	默认聊天预设 ID，需提前在面板或命令中创建	`default`
`chaite.cloudApiKey`	否	接入 Chaite Cloud 时填写的密钥，留空则本地运行	`sk-xxxxxxxx`

如何确认成功

重启机器人后，检查 plugins/chatgpt-plugin/config/ 是否生成 config.json 与 config.yaml，并可发送 #chatgpt管理面板获取面板 token 确认插件已加载。

常见问题

Q：安装依赖时 sqlite-vec 报错怎么办？

A：sqlite-vec 只用于向量检索增强，属可选依赖。当前平台不可用时，记忆功能仍保留基础存储、关键词检索与 LIKE 回退，可忽略该报错。

Q：配置文件用 JSON 还是 YAML？

A：默认位于 plugins/chatgpt-plugin/config/config.json，也可改写为 YAML，两种格式都支持，修改保存后插件会自动热加载。

Q：聊天数据保存在哪里？

A：核心配置、聊天历史和操作日志分别保存在插件 data 目录下的 data.db、history.db 与 operation_logs.db，存储默认使用 SQLite。

Q：升级后旧数据会丢失吗？

A：升级时会自动从旧的 data.db 分批复制数据，并保留旧表作为兼容备份，一般不会丢失。

注意事项

插件基于 Chaite 内核，v3 处于大幅重构中，遇到问题可提 issue。
#chatgpt强制更新会放弃本地修改后重新拉取，请谨慎使用。
如接入 Chaite Cloud，需填写 cloudApiKey 并开放 host/port。

核心亮点

多模型支持：可接入 OpenAI、Claude、Azure 等多种大模型，灵活切换
上下文记忆：支持多轮对话和会话隔离，聊天更自然
丰富扩展：集成图片生成、语音回复、角色扮演等玩法

不足之处

依赖云崽框架，非云崽用户无法直接使用
文档/社区待观察

适用场景

QQ 群聊中提供智能问答和闲聊陪伴
搭建个人 QQ 机器人，实现定制化对话助手
社区或粉丝群内提供信息查询、娱乐互动

替代项目

nonebot-plugin-chatgpt、koishi-plugin-chatgpt、wechat-bot-chatgpt

项目介绍

chatgpt-plugin 是对话助手领域的开源项目，由 ikechan8370 开发，2022 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,076）位列前 30%，在对话助手分类中处于中上游。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。开源插件，GPL-3.0许可，免费使用，需自行部署到云崽机器人。

它主要面向的使用场景是：QQ群聊中提供智能问答和闲聊陪伴。同类可对比的替代方案包括 nonebot-plugin-chatgpt、koishi-plugin-chatgpt、wechat-bot-chatgpt。

上一篇：gptel

下一篇：OpenGptChat