NapCatQQ 保姆级指南快速搭建基于 NTQQ 的 QQ 机器人【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ想给群里做个自动回复的机器人却要手动回消息、一条一条写 NTQQ 协议、再自己保活NapCatQQ 是基于 NTQQ 的现代化无头 QQ 机器人框架把消息收发、群组管理、文件处理封装成现成接口新手也能几分钟跑起来。 五分钟上手体验克隆仓库git clone https://gitcode.com/gh_mirrors/na/NapCatQQ安装依赖pnpm install要求 Node 18 及以上直接去官方 Release 页下载最新版运行Windows 下启动器会自动从注册表定位本地 NTQQ 安装路径想跑源码就用仓库里的 dev 脚本构建启动QQ 登录成功后WebUI 默认在 6099 端口就绪访问令牌会直接发到你 QQ 上不用再手动抄配置在 WebUI 里配置 OneBot11 网络连接示例配置默认是 HTTP 3000 端口、WebSocket 3001 端口只监听本机它到底解决什么问题不用碰底层协议核心层直接封装了 NTQQ 内核的服务调用你只管写业务逻辑。适合想快速出第一个机器人、不想啃协议的新手。低内存环境长跑官方强调可在低内存系统长时间稳定运行。适合把它 7x24 挂在旧办公机或低配服务器上。标准 OneBot11 接口完整实现标准接口现有 OneBot 生态的工具和代码可以搬过来。适合从别的协议端迁移过来的开发者。三种实战玩法让机器人自动接管客服消息用 OneBot11 事件推送监听进来的消息收到提问就调消息 API 自动应答。消息层 packages/napcat-core/apis/msg.ts 覆盖文本、图片、语音、转发和表情点赞日常客服对话基本够用。把禁言、踢人这类群管理动作自动化群 API packages/napcat-core/apis/group.ts 覆盖成员管理、管理员、禁言和公告设置OneBot 侧的 SetGroupBan 等 action 也现成可用。配上自己的关键词规则违规消息处理不再需要你盯群。群文件自动接收与转发文件 API packages/napcat-core/apis/file.ts 支持群文件列表、在线文件和闪传OneBot 的 action 目录 下还有专门的 file 子目录提供下载与流式接口。有人发文件进群你可以让它自动归档或转发到另一个群。️ 工具箱里有什么消息收发文本、图片、语音、合并转发、表情点赞实现在 packages/napcat-core/apis/msg.ts群与好友群成员管理、群公告、好友列表和私聊见 packages/napcat-core/apis/group.ts 与 friend.tsOneBot 协议扩展action 目录按 go-cqhttp 兼容、群操作、文件、系统分组连重启、取 CSRF 这类系统操作都有Web 管理界面packages/napcat-webui-frontend/ 提供登录、网络配置和调试页面日常调参不用改文件⚠️ 避坑与调优先读官方文档再动手项目声明不解答基础对接问题文档教程齐全自查比等回复快。别把网络端口直接暴露公网默认 OneBot11 配置只监听本机要对外连接就配上 token否则接口谁都能调。排错时先开日志packages/napcat-core/helper/config.ts 里提供 fileLog 与日志级别开关写文件日志后定位问题省事得多。QQ 升级后同步更新 NapCat框架要挂进指定版本的 NTQQ 运行版本不匹配时优先更新发行版再查其他原因。 怎么扩展它插件系统packages/napcat-onebot/network/plugin/ 提供插件加载器packages/napcat-plugin-builtin/ 里有个现成示例从配置界面到命令前缀的处理都能直接照着抄写第一个插件不费劲。兼容性完整实现 OneBot 11action 目录里的 go-cqhttp 分组保留了传统接口命名老代码迁移成本很低。社区项目开源欢迎提 PRQQ 群入群密钥可以在 WebUI 的关于页面获取社区会限制无编程基础者入群先去文档里热身。如果你需要的是一个能长期挂机、接口齐全的无头 QQ 机器人NapCatQQ 值得进你的技术栈——仓库里翻翻目录或者直接从「五分钟上手体验」跑一遍试试。【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考