chatgpt-plugin

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 对话助手 🍴 复刻 128 🐛 待处理 24 👀 关注 7
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1078
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源插件,GPL-3.0许可,免费使用,需自行部署到云崽机器人。

项目预览

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

项目数据

分类对话助手
开发团队ikechan8370
定价模式🏷️完全免费
价格说明开源插件,GPL-3.0许可,免费使用,需自行部署到云崽机器人。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议GPL-3.0
主要语言JavaScript
技术栈/模型bot,chatgpt,qq,yunzai,yunzai-bot
GitHub 星标★ 1078
上线时间2022-12-06 00:00:00
代码更新2026-10-15
仓库体积37.4 MB
本站数据更新2026-11-09
维护状态较活跃
收录时间2026-08-09
浏览次数3

项目介绍

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

Star 增长趋势

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

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

技术标签

使用教程

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

环境要求

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

安装与启动步骤

  1. 1克隆插件代码

    进入 Yunzai 根目录下的 plugins 目录,克隆插件仓库,确保插件放在 plugins/chatgpt-plugin 下。

    cd plugins
    git clone https://github.com/ikechan8370/chatgpt-plugin.git
  2. 2安装插件依赖

    进入插件目录用 pnpm 安装依赖;sqlite-vec 为可选依赖,平台不支持时记忆功能仍可基础使用。

    cd chatgpt-plugin
    pnpm install
  3. 3启用插件

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

    node app
  4. 4修改配置文件

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

  5. 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

上一篇:gptel

下一篇:OpenGptChat

同类项目推荐

seq2seq_chatbot 开源

用TensorFlow快速搭建带注意力和束搜索的对话机器人

基于seq2seq模型的简单对话系统的tf实现,具有embedding、attention、beam_search等功能,···

★ 334 2026-08-09
txtchat 开源

本地文件秒变 AI 知识库,离线问答更私密

⚡ Local chat assistants with AI superpowers

★ 339 2026-08-09
dual-obsidian-client 开源

在 Obsidian 里直接对话 AI,让笔记秒变智能助手

A skilled virtual assistant for Obsidian.

★ 240 2026-08-09
python-whatsapp-bot 开源

纯 Python 快速搭建 AI 微信机器人,对话即服务

Build AI WhatsApp Bots with Pure Python

★ 1550 2026-08-09
dialogflow-web-v2 开源

给网站快速加一个带富文本的 Dialogflow 聊天框

Dialogflow Web Integration. Supports rich components

★ 431 2026-08-09
JARVIS-MARK5 开源

一个助手搞定图像、文档和办公,像 JARVIS 一样指挥 AI

JARVIS - A ASSISTANT WHICH IS NEEDED FOR EVERYONE

★ 95 2026-08-09
HackBot 开源

用聊天方式搞定网络安全问答、代码审计和扫描分析

AI-powered cybersecurity chatbot designed to provide helpful and accurate answers to···

★ 365 2026-08-09
ChatPilot 开源

拖文件、发网址,即刻拥有 Kimi 式智能对话界面

ChatPilot: Chat Agent Web UI,实现Chat对话前端,支持Google搜索、文件网址对话(RAG)、···

★ 603 2026-08-09
dotnetmaui-chatgpt-app-oss 开源

用 .NET MAUI 快速打造跨平台 ChatGPT 聊天应用

ChatGPT is an open-source chat application developed with .NET MAUI, employing OpenA···

★ 110 2026-08-09